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This publication is organized in three 
chapters. Chapter 1 is an introduction 
describing the relationship between the 
compiler and the operating system, and the 
overall organization of the compiler. 
Chapter 2 is a general description of each 
logical phase followed by descriptions of 
each of the physical phases contained in 
the logical phase. Chapter 3 consists of 
flowcharts, tables and routine directories. 
The flowcharts show the relationship 
between the routines of each phase, while 
the tables and directories list the 
routines and their functions. 


The appendixes contain topics of special 
importance and reference material. 


The convention has been followed in this 
manual of printing all PL/I language items 
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PURPOSE OF THE COMPILER 


The IBM System/360 Operating System PL/I 
(F) Compiler analyzes and processes source 
programs written in PL/I, and translates 
them into a form suitable for input to the 
Linkage Editor or Linkage Loader. When 
errors are detected in the source program, 
appropriate diagnostic messages are 
produced. The compiler functions within 
IBM System/360 Operating System and may be 
used on machines where at least 45,056 
(44K) bytes of main storage are available 
for the compilation (exclusive of storage 
requirements for the operating system). 


THE COMPILER AND THE OPERATING SYSTEM 


The PL/I (F) Compiler is a processing 
program of IBM System/360 Operating System. 
The compiler consists of a number of phases 
under the supervision of compiler control 
routines. The compiler communicates with 
the control program of the operating 
system, for input/output and other 
services, through the control routines. 


A compilation is introduced as a job 
step under the control of the operating 
system, via the JOB statement, the execute 
(FXEC) statement, and the data definition 
(DD) statements of the Job Control 
Language, for the input/output data sets. 
Cataloged procedures are provided to keep 
these statements to a minimum. A 
discussion of the introduction of a 
compilation as a job step, and of the 
available cataloged procedures, is given in 
the publication IBM System/360 Operating 
System, PL/I (F) Proarammer's Guide. 


The source program to be compiled 
appears as input to the compiler on the 
SYSIN data set. The compiler uses SYSUT1 
(required if the main storage is 
insufficient to contain the program) and 
SYSUT3 (required if the 48-character set or 
the compile-time processor is used) as work 
data sets. The SYSPRINT data set is 
mandatory. The SYSPUNCH and SYSLIN data 
sets are used, depending on the options 
specified by the source programmer, to 
contain the output from the compiler. 


The overall data flow associated with a 
compilation, and the data sets used in the 
compilation, are illustrated in Figure 1. 


CHAPTER 1: INTRODUCTION 


A compilation is initiated by loading 
the compiler control routines from the Link 
Library. The compiler control routines 
then carry out their own initialization, 
including loading those compiler control 
routines which remain in storage throughout 
the compilation. These routines perform 
the following functions: 


1. Act as the interface between the 
compiler phase and the operating 
system, controlling all input/output, 
storage allocation, program 
interruptions, storage dumping, etc. 


2. Supervise the loading of compiler 
phases in accordance with source 
program options and information 
obtained from the source program by 
the compiler phases. 


3. Supervise all workspace used by the 
compiler for information concerning 
the source program. This includes any 
spilling from main storage to 
auxiliary storage in order to 
accommodate large source programs, the 
conversion of symbolic references to 
absolute addresses, and the conversion 
from absolute addresses to symbolic 
references. 


4. Provide a number of routines to assist 
in compiler debugging. 


The compiler options specified are 
interpreted and the appropriate action 
taken. The environmental options, such as 
storage size and device type, are used to 
calculate the text and dictionary block 
Size and the “spill" point (i.e. the point 
at which the main storage available is 
insufficient to contain the dictionary and 
text). 


To determine the block size a table 
contained in Phase AB is used. The storage 
size is used as the argument to search the 
table. When the correct entry is found, 
the text block size and the dictionary 
block size values are extracted ane used 
for the compilation. 


The options are instructions to the 
compiler. Some of these require a phase to 
be loaded that would not otherwise be 
loaded. When an option of this type is 
found, a request for the phase required is 
inserted into the status byte in the phase 
directory. Other options are in the form 
of instructions to a phase that is always 
loaded. These instructions are also placed 
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Figure 1. Compiler Data Flow and Data Sets Used 
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in coded form in the communications region 
, of the dictionary, generally in the Control 
Code word (see CCCODE in Appendix B). 


COMPILER ORGANIZATION 


The PL/I (F) Compiler comprises a number of 
logical phases, each of which consists of 
several physical phases as shown in 
Appendix A. 


The compiler phases and their 
corresponding functions are indicated in 
Figure 2, and the organization of the 
compiler is shown in Figure 3. 


Control is passed between the phases of 
the compiler via the control routines. 2. 
After each phase has been executed, it 
branches to the control routine, which 
selects from its load list the next phase 
to be executed. 


Communication between the phases is 
implemented by the following: 


1. The text string. The text string at 
the start of the compilation is input 
text. This is converted by the 
compile-time processor, if necessary, 
into a string which is PL/I source 
text. The characters in this string 
are translated into a code internal to 
the compiler. The phases of the 
compiler gradually process the text 
until the final form is the object 


program, consisting of a string of 
machine instructions. For the 
compiler proper, the text code bytes 
used, and formats of statements at 
different stages of the compilation, 
will be found in Appendix D. 


The text is broken down into a number 
of blocks, depending upon the size of 
the machine. Each block has a 
symbolic name which is independent of 
the physical location of the block in 
storage. Thus, the text blocks may be 
moved around in main storage under the 
supervision of the compiler control 
routines, and spilled on to auxiliary 
storage if insufficient main storage 
is available. 


The dictionary. The dictionary 
consists of a number of blocks, each 


with a symbolic name. Part of the 
first dictionary block is used as a 
communications region (see Appendix F) 
between phases, and for this reason 
the first block is never spilled, even 
when the source program to be compiled 
exceeds available storage. The 
communications region contains such 
information as the addresses of the 
heads of chains, the symbolic start of 
text, etc. The remainder of the 
dictionary contains all information 
relating to identifiers appearing in 
the program, temporary storage areas 
required, etc. For the compiler 
proper, the format of all dictionary 
entries will be found in Appendix c. 
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Compile-time Processor 
Read-In 


| 
| 
| 
| 
| 
| 
| 
{ 
| Dictionary 
| 
| 
| 
| 
| 
| 
| 
|Pretranslator 


Translator 


Aggregates 


Optimization 


Pseudo-Code 


Processes those features of the language that are more 


SR Sie OS A ee SE) SD a Se EE ee A ee SE ee ee ee ee qe se ee ae Nay qre eis coe are ey epee ie EN kth aD ear ED ee ae ee 2 ee mie sae a | 
Function | 


a a a ee ee Se ee re ee ee =| 


Reads input text, executes any compile-time statements 
contained in it, and modifies text as directed, producing 
modified text for further compiler processing. 


Checks source program syntax and removes all superfluous 
characters, such as comments and non-significant blanks, 
from the text string. 


Removes all BCD identifiers and attribute declarations from 
the source string, and replaces them by symbolic references 
to dictionary entries. The dictionary entries contain all 
the consistent declared attributes, and all the attributes 
specified in the language in default of source program 
specifications. Error messages are generated for all 
inconsistent attributes. 


easily processed in their original PL/I form, than when the| 
original syntactic form has been lost in later phases. The] 
Pretranslator carries out these modifications which include| 
the rearranging of the order of certain I/O statements, the| 
creation of temporary variables for procedure arguments 
which are expressions, the conversion of array and 
structure assignments to a series of DO-loops surrounding 
scalar assignments, and the removal of iSUB expressions. 


Converts the original PL/I syntactic form to an internal 
syntactic form, referred to as “triples." Triples consist 
of the original source program operators and operands, but 
rearranged so that the operations specified in the source 
string may be carried out in their proper order. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
Carries out all structure and array mapping, so that | 
elements are aligned on the correct storage boundaries. | 
When it is not possible to carry out the mapping at | 
compilation time, such as when the aggregates contain | 
string lengths or array bounds which are specified by | 
expressions, object code is produced to do it at object | 
time. This phase also checks that items’ DEFINED on arrays | 
and structures can be mapped consistently. | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
J 


If optimization is requested, the optimization phases 
attempt to reorder triples for subscript address 
calculations and generate efficient pseudo-code for DO-loop 
control. This enables some PL/I programs to compile into 
faster object code at the cost of extra compile time. 


Converts the triples to a form closely resembling machine 
instructions, in which registers are represented 
symbolically, and storage locations are represented by | 
dictionary references with offsets. The final pseudo-code 
version of the text also contains a number of special 
pseudo-code items for the guidance of later phases. 
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@Figure 2. Compiler Logical Phases (Part 1 of 2) 
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Figure 2. Compiler Logical 


Description | 
Searches the dictionary for all entries requiring storage, : 
and allocates offsets to each item, either within its 
AUTOMATIC block, or within the STATIC storage area. Code 
is compiled to set up dope vectors and pointers at object 
time, for allocations of controlled variables and 
temporaries, the storage for which must be obtained during 
the execution of the object program. Prologue code is 
generated for each block of the object program. 


Allocates physical registers to the symbolic registers 
which have been requested by earlier phases, and also 
ensures that all the storage location offsets allocated in 
previous phases can be addressed by the insertion of 
additional instructions, where neceSsary. 


Completes the translation to machine code instructions, by 
calculating branch destination addresses inserted 
symbolically by earlier phases. Loader text is then 
produced for the machine instructions, constants, INITIAL 
values in STATIC storage, and all the constant data 
required for block initialization. ESD and RLD cards are 
produced to enable the object program to be edited by the 
Operating System/360 Linkage Editor or the Linkage Loader. 
The Final Assembly Phase also produces a listing of the 
object code produced. 


Entered at the end of every compilation. The dictionary is 
examined to determine whether there are any diagnostic 
messages to be printed out. If there are none, the 
compilation is terminated by the compiler control. If 
there are diagnostic messages to be printed out, the error 
dictionary entries are processed and the messages are 
printed. The texts of all the diagnostic messages are held 
in modules XG through YY. 


Phases (Part 2 of 2) 
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Note: For descriptions of terms and 
abbreviations used in the text during a 
compilation which are mentioned in this 
chapter, refer to Appendix D.11. 


COMPILER CONTROL AND 48-CHARACTER SET 
PREPROCESSOR 


COMPILER CONTROL 


When the PL/I (F) Compiler is invoked by 
the calling program (e.g., the Job 
Scheduler) of the operating system, the 
Compiler Control module IEMAA is loaded and 
entered. IEMAA is resident during the 
whole compilation; it controls the 
following functions: 

Initialization 

Character translation 

Communication between phases 

Text and dictionary block control 

Scratch storage control 

Storage requirements 

Phase loading 

Phase directory construction 

Diagnostic message control 

Input/output control 

Program check handling 


Compile-step termination 


Initialization 


Initialization is achieved by module AA 
linking to module AB. Module AB performs 
the detailed initialization of the 
compiler, and provides the following 
functions: 


Opens SYSIN and SYSPRINT data sets 


Constructs a phase directory (for details 
refer to Appendix B) 


Sets up a communications region in the 
dictionary (for details refer to Appendix 
F) 
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Scans option list 


Obtains space for text blocks and 
dictionary blocks. 


Opens SYSUT3 and SYSPUNCH as necessary 


Prints a list of options used in current 
compilation 


Loads phase AN to handle a normal 
dictionary, or phase AL if an extended 
dictionary is requested. 


On return from module AB, the first 
compiler phase is loaded and entered. 


Character Translation 


The character translation tables (see 
Appendix D.1) provide the facility for 
converting external code to a compiler 
internal code, and for converting the 
internal code back to the external form. 
These tables thus prevent the compiler from 
becoming character code dependent, and 
enable the scanning routines to process the 
input source statements more efficiently. 
Note that the contents of these tables are 
different during compile-time processing 
from the contents during compilation 
proper. 


Communication Between Phases 


The communications region is an area 
specified by the control routines, and used 
to communicate necessary information 
between the various phases of the compiler. 
The communications region is resident in 
the first dictionary block throughout the 
compilation. 


Entry to the various compiler control 
routines is via a transfer vector. Details 
of the transfer vector and the organization 
of the communications region appear in 
Appendix F. (Note: The use of the 
communications region during compile-time 
processing is described in Appendix J.) 


Text and Dictionary Block Control 


Block control is achieved by a system of 
text and dictionary references. If the 
program in storage becomes too large, 
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blocks are placed on an external file, 
SYSUT1. The block control routines contain 
the input/output control. 


Block Control Area 





The block control area contains two tables, 
DSLOTS and TSLOTS, and is held in modules 
AL/AN. The DSLOTS table contains 70 4-byte 
Slots, and the TSLOTS table contains 96 
4-byte slots. The first six slots in each 
table are used by the compiler control 
routines for holding general block 
information. The remaining slots contain 
details of the status and position of text 
and dictionary blocks, one slot per block. 


The format of each slot is as follows: 


1 byte indicator 


3 byte address - (a) if the block is in 
main storage it 
contains the absolute 
address of the start 
of the block. 


(b) if the block is on 
disk it contains the 
relative track 
address of the block 
in the spill file. 


The format of the indicator byte is x 
‘ab' where: 


ab = FF if the block has not been 
allocated 

a= 8 if the block is in storage 

a= 0 if the block is on the spill 
file 

b=4 if the block is busy (i.e., 
locked into storage) 

b= 3 if the block is wanted (i.e., 
spillable but preferably kept in 
storage). 

b= 2 if the block is not wanted 
(i.e., information to be 
retained but block may be 
spilt). 

b=1 if the block is free (i.e., 


information no longer required). 
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Text Block Chaining 


When text blocks are chained, the second 
byte of the last but one word of each block 
contains the block number of the next block 
in the chain. 


Scratch Storage Control 


Scratch storage of 4K bytes is guaranteed 
to all phases. The control routines split 
the 4K-block into discrete sections, each 
Of 512 bytes, and allocates them as 
required. 


Storage Requirements 


The PL/I (F) Compiler requires main storage 
for the following purposes ; 


Compiler processing phases 
Print buffers 

Compiler control routines 
Dictionary area 

Text area 

Input/Output buffers 
Input/Output routines (QSAM) 


The main storage required by each phase 
of the compiler need be contiguous only for 
each control section. 


During the read-in logical phase a 
minimum of two dictionary blocks and two 
text blocks is available in storage . 
simultaneously. During the optimization 
logical phase, a minimum of three 
dictionary and five text blocks is 
available in storage simultaneously. 


During the rest of the compilation four 
dictionary blocks and four text blocks are 
available in storage simultaneously. 


The dictionary and text block size is 
chosen according to the amount of main 
storage available to the compiler. The 
SIZE option, interpreted at invocation 
time, provides the value used to determine 
the block size. A table contained in Phase 
AB is searched, using the SIZE option as an 
argument. When the correct entry is found, 
the block size is extracted. 


Appendix E shows details of storage 
allocation. 


Phase Loading 


Phase loading routines include phase 
marking (where phases are indicated as 
wanted or not wanted), phase loading, and 
phase deleting facilities. The phase 
directory is constructed for this purpose. 


Phase Directory Construction 


Because of the number of phases in the 
compiler, the phase directory is split into 
halves. The first half is constructed 
during the initialization of the compiler; 
also a list of names of the phases in the 
second half is kept in Phase AA. This list 
is used to pass status indications (i.e., 
whether phases are wanted or not wanted) — 
from the first half to the second half. 
Phase JZ uses the list to construct a new 
directory for the second half. (The error 
message phases have their own phase 
directory, which is built in phase XB and 
uses the same space in AA as the phase 
directory proper.) 


The phase directories are constructed by 
use of the BLDL macro and a build list. 
The format of the build list is fully 
described in the publication IBM System/360 
Operating System, Supervisor and Data 
Management Services. For details of the 
phase directory see Appendix B. 


Diagnostic Message Control 


Diagnostic message control routines cause 
diagnostic messages to be placed in a chain 
in the dictionary. 


Input/Output Control 


The I/O control routines involved act as an 
interface between the compiler phases, and 

SYSIN, SYSPRINT, SYSLIN, and SYSPUNCH data 

sets. (See Figure 4.) 


Program Check Handling 


The compiler handles all program checks. 
Control can be passed to a phase to enable 
it to deal with the check. 


| Compile-step Termination 


The compiler completion code is picked up 
and control is returned to the calling 
program. 


The compiler completion codes are as 
follows: 


Code Meaning 

0 No diagnostic messages issued; 
compilation completed with no 
errors; successful execution 
expected 





4 Warning messages only issued; 
program compiled; successful 
execution is probable 


8 Error messages issued; compilation 
completed, but with errors; 
execution may fail 

12 Severe error messages issued; 
compilation may be completed but 
with errors, successful execution 
improbable. If a severe error 
occurs during compile-time 
processing, the compilation will be 
terminated and, if the SOURCE 
option has been specified, a 
listing of the PL/I program text 
produced by the compile-time 
processor will be printed. 


16 Termination error messages issued; 
compilation terminated abnormally; 
successful execution impossible. 


COMPILER CONTROL MODULES 


In addition to modules AA and AB, further 
modules, AC, AD, AE, AF, AG, AH, AI, AK, 
AL, AM, AN, and JZ are used in compiler 
control. The functions of these modules 
are briefly described in the following 
paragraphs. 


Module AC 


Module AC controls reading and writing 
operations on SYSUT3, the intermediate 
file. It is loaded only if the CHAR48 or 
MACRO option is specified, and is deleted 
at the end of the Read-In Phase. 
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Module AD 


Module AD performs inter-phase dumping. 


All specified active storage is dumped 
at the end of the phases stated or implied 
in the DUMP option. If the DUMP option 
includes either I, for the Annotated 
Dictionary Dump, or E, for the Annotated 
Text Dump, or both, then phase AD will load 
either phase AH, or phases AI and AJ, or 
all three, to produce the required output. 


The DUMP Option 


The DUMP option which is specified in the 
PARM field of the EXEC card indicates where 
dumping of main storage is to take place. 
It may be specified in one of the following 
ways: 


1. DUMP, means a dynamic dump is required 
(the dump routine will be called by a 
running phase) 


2. DUMP= (area, X4¢X%2ae%37+02-eXn) means a 
dump of the storage after the named 
phase where x is the name of a phase. 


Area is any combination of TDPSCIE: 
text blocks 

dictionary blocks 

phases loaded 

scratch storage 

control phase 

annotated dictionary blocks 
annotated text blocks 


On 


WHOM 


The general syntax is: 


DUMP (=(lareal], {x| (y,z)},...)] where x, 
y and z are phase names. 


A single phase name indicates dumping of 
storage after this single phase. A pair of 
phase names indicates a continuous group of 
phases after which dumping of storage is to 
occur. 


The dump will appear on SYSPRINT, 
inserted into the normal compiler output. 


If area is omitted the default taken is 
DTSP. If a program check occurs and DUMP 
has been specified then area will be given 
the default DTSPC. 


If the area specifies both T and E or 
both D and I, only the relevent edited dump 
will be printed. 


If the area contains P, a message is 
printed on completion of every phase, 
whether mentioned in the DUMP parameter or 
not. 


Use of the DUMP option may cause the 
compiler to use about 8K bytes more main 
storage than the SIZE option specifies. 
This is because SIZE specifies the amount 
of main storage the compiler can use for 
normal compilation and does not allow for 
the internal compiler diagnostic dumps. 


Example of an EXEC card using the DUMP 
option: 


//7STEP1 EXEC PROC=PLiLFC, 
PARM. PL1L=* DUMP=(TIP,OE,QU) ° 


This statement specifies compilation using 
the DUMP option to obtain a printout of the 
text blocks, the annotated dictionary, and 
the loaded phases after the completion of 
compiler phases OE and QU. 


Module AE 


Module AE is the finalization of the 
Read-In Phase control. (See Fig.4, Note*) 


Module AF 


Module AF is a control section consisting 
of a table containing the compiler options 
which may be used during a compilation. 
The table is constructed at system 
generation time. The control section is 
brought into storage by the initialization 
Module .AB at compilation time. A 
description of the use of Module AF is 
given in Appendix G. 


Module AG 


Module AG closes SYSUT3 for output, and 
re-opens it for input. 


The closing and opening operations are 
performed in the following order: 


CLOSE 
alter macro-type in data control block 
(DCB) 


OPEN (INPUT) 


switch routine ZURD to point at the 
SYSUT3 data control block 
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Module AH 


Module AH produces a dump of the 
dictionary. It prints out the 
communications region in the first block, 
and the offsets tables for each block if 
the extended dictionary option is in use. 
The remainder of each block is printed out 
entry by entry. The BCD is translated for 
those entries containing BCD. At the end 
of the dump, a list of all the dictionary 
codes used is given, with an explanation 
for each code. 


The module is called by phase AD only if 
an I is specified in the area field of the 
DUMP option. 


Modules AI and AJ 


Modules AI and AJ are called, if E is 
specified in the area field of the dump 
option, to provide an ‘easy-to-read' text 
print in which the triples and pseudo-code 
items comprising the text are printed 
separately. This option is available 
between phases IA and OE inclusive. 


Module AK 


Module Ak is the closing routine of the 
compiler. Its function is to release main 
storage used for dictionary, text blocks, 
scratch storage, and completed phases. If 
batch compilation is not specified, module 
AK closes all the files used by the 
compiler. If a batch compilation is 
specified, a check is made to determine 
whether any source programs are still to be 
compiled. Where there are none module AK 
closes all files. Where one or more 
programs remain to be compiled, the spill 
file only is closed, the batch delimiter 
card is scanned for syntax errors, and 
control is returned to module AA. 


Module AL 


Module AL contains the control routines for 
dictionary and text-block handling for the 
extended dictionary. 
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Module AM 


Module AM marks phases as either wanted or 
not wanted, depending upon the compiler 
invocation options. Phases that are always 
loaded are marked wanted. 


AM is the first compiler phase loaded 
after compiler initialization. It tests 
the relevant bits in the Control Code word 
(CCCODE) and marks the phases accordingly. 


Module AN 


Module AN contains the routines for 
dictionary and text-block handling for the 
normal-sized dictionary. 


Module AT 


Module AT provides extra debugging features 
during compiler runs. The three features 
of this module are: 


1. A ‘TRACE’ of all instructions executed 
between specified Locations within 
specified compiler modules. 


2. A ‘FLOW’ of branches taken between 
specified locations within specified 
compiler modules. 


3. The ability to VERIFY and REP(replace) 
patches within specified compiler 
modules. 


Note: Features 1 and 2 can be inhibited 
until a particular statement is 
reached. 


The TRACE/PATCH Option 


The following must be done to use the 
facilities described above in Module AT: 


1. ‘'T' (Trace or Flow) or ‘'P* (Verify or 
Rep) must be inserted in the compiler 
option list. 


2. A size of at least 12K less than the 
size available must be specified. Do 
not attempt to use SIZE=999999. 


3. As the output will go to a dataset 
named TRACEOUT, the following DD card 
will also be required in the JCL for 
the compile step: 


//TRACEOUT DD SYSOUT=A 


In addition, control cards will be 
required which must be inserted before the 
first card of the source program. Up to 10 
each of TRACE/FLOW and VERIFY/REP cards are 
permitted. 


To obtain TRACE/FLOW facilities the 
control card should contain the following 
information: 


* in card column 1 
Keyword ‘TRACE’ or ‘FLOW' 


Two-letter module name 
of start of 
Four-digit hexadecimal Trace or Flow 


offset of instruction 


Two-letter module name 

of end of 
Four-digit hexadecimal Trace or Flow 
offset of instruction 
(STAT=nnnnn]) where nnnnn is 
five-digit decimal PL/I 
statement number at 
which Trace/Flow is to 
start. 
Note: This field is 
optional and may be 
used only if the module 
in which TRACE/FLOW is 
to start updates ZSTAT. 


Example: 
* TRACE GB 012B GU 036C 


Note: Fields should be separated by at 
least one blank, and end in or 
before column 72. 


To obtain the PATCH facilities the 
control card should contain the following 
information: 


* in card column 1 
Keyword ‘VERIFY’ or ‘REP*‘ 


Two-letter module name 
of Patch 
Four-digit hexadecimal location 


offset 


Note: Hexadecimal Patch data may be 
separated by commas if desired. 


Example: 
* VERIFY GB 032A 
VERIFY and REP instructions are carried 


out as soon as the module concerned is 
loaded. If the data does not compare on 
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Verify operation, an error message will be 
given on the data set TRACEOUT. Note that 
Rep operations do not depend on a previous 
valid verify operation. 


Module Fil 


Module F1 checks whether Syntax Check 
should terminate compilation. The three 
options for the Syntax Check are recognized 
in module AB and flags are set. On 
completion of the Read-in and Dictionary 
phases, these flags are tested by module 
F1, which was loaded when phase FX released 
control. The decision to terminate or 
continue is made based on the flag settings 
and the level of error severity encountered 
(by inspecting the heads of the error 
chains), and a special message is issued at 
this point. 


Module JZ 


Module JZ builds the second half phase 
directory. A build list is constructed 
from the second half list held in Module 
AA; a BLDL is performed on this list. The 
phase directory is then reconstructed in 
Module AA for the second half of the 
compiler. 


48-CHARACTER SET PREPROCESSOR 


Phase BX is the 48-character set 
preprocessor. It is loaded on programmer 
option and receives, as input, source text 
in the 4%8-character syntax. 


The preprocessor scans the input text 
for occurrences of characters peculiar to 
the 48-character set, and converts these to 
the corresponding 60-character symbols. It 
then puts out the adjusted text onto 
auxiliary storage ready for Phase CI, the 
first pass of the Read-In Phase. 


The text is read in record by record. 
It is then scanned for alphabetic 
characters which may be the initial letters 
of operator keywords, for periods, and for 
commas. Items within comments or character 
strings are ignored. 


When a possible initial letter is 
discovered, tests are made to determine 
whether or not one of the reserved operator 
keywords has been found. If one has been 
found, it is replaced by its 60-character 
set equivalent. Similarly, appearances of 
two periods are replaced by a colon, anda 
comma-period pair is replaced by a 
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semi-colon if the comma-period pair is not 
immediately followed by a numeric 
character. 


Allowance is made for the possibility 
that a concatenation of characters which is 
meaningful in the 48-character set may be 
split between two records. 


Before the text is processed a copy of 
the original input is preserved. The 
output from the preprocessor is the 
transformed text, record by record, 
followed by the original text. The Read-In 
Phase processes transformed text but prints 
out the original. 


The 48-character set preprocessor uses 
Compiler Control routine ZURD to obtain 
input, and routine ZUBW to place its output 
onto auxiliary storage. 


Note: If the MACRO option is specified, all 
the processing described above is 
done by the compile-time processor, 
and phase BX is bypassed. 


COMPILE-TIME PROCESSOR LOGICAL PHASE 


The compile-time processor consists of six 
physical phases. Each of these phases is 
executed once, unless an INCLUDE data set 
is encountered. In this case certain 
phases will be re-executed. 


The compile-time processor moves source 
text that does not contain compile-time 
statements directly into text blocks. 
During this process invalid characters are 
replaced by blanks, and line numbers are 
encoded and inserted into the text. 
Compile-time statements are decoded and 
translated into an internal form and then 
placed directly into text blocks. An entry 
is made into the dictionary for each 
compile-time variable, procedure, label, or 
INCLUDE identifier. 


A second pass is then taken over these 
text blocks, during which compile-time 
statements are executed and the PL/I source 
program text is scanned and replacements 
are made. The output from this pass is a 
PL/I source program contained on SYSUT3 
and, optionally, a punched card deck. 


If during the second pass, an INCLUDE 
data set is processed, the entire procedure 
indicated above is executed recursively to 
process this text. 


Text and dictionary formats used by the 
compile-time processor are contained in 
Appendix J. 


Line Numbering 


As the input is being processed a unique 
line number is assigned to every logical 
record processed. If a listing of the 
input is requested, these line numbers are 
written out beside the appropriate line. 
The line numbers are also encoded and 
inserted into the text so that diagnostics 
can be keyed to them. These line numbers 
are also output on SYSUT3, to aid the user 
in determining from which input line a 
particular line of output came. 


Phase AS 


This phase, consisting of one physical 
module, is loaded if the MACRO option is 
specified. It is resident throughout 
compile-time processing until the cleanup 
phase (BW) is invoked. 


This phase controls the loading of the 
subsequent compile-time processor phases. 
The initialization phase (AV) is loaded 
only once. The two processing phases (BC 
and BG) are loaded and executed once unless 
an INCLUDE data set is processed. In this 
case phase AS reloads the processing phases 
to process this data set. 


In addition, phase AS contains a set of 
service routines used by both processing 
phases. Access to these routines is via a 
transfer vector located at the beginning of 
phase AS. 


Phase AV 


This phase consists of one physical module. 
Its purpose is to initialize certain cells 
in the communications region for the 
compile-time processor phases. 


Phase BC (BE, BF) 


Phase BC consists of three physical. 
modules, BC, BE, and BF. Module BE 
contains the control routine. 


Phase BC accepts input text, moving it 
into text blocks until a compile-time 
statement is found. (For a description of 
the use and layout of text and dictionary 
blocks, see Appendix J.) When a 
compile-time statement is encountered, it 
is encoded into a set of interpretive 
instructions and, except for compile-time 
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procedures, added to the current text 
block. Compile-time procedures are 
similarly encoded, but are placed in 
separate text blocks. 


As compile-time statements are encoded, 
all non-keyword identifiers encountered are 
entered into the dictionary, together with 
any attributes that are known. Entries are 
also made in the dictionary for constants 
and iterative DO-loops. 


During phase BC, invalid characters 
occurring outside of strings and comments 
cause a diagnostic to be printed. They are 
converted to blanks. Invalid characters 
can thus be used for markers of various 
sorts in text blocks. Diagnostics are 
given for syntax errors in compile-time 
statements. Line numbers are encoded and 
inserted into. the text for the use of the 
phase BG scan. All input characters are 
converted to their EBCDIC representation 
before they are processed. 


Phase BG (BI, BJ) 


Phase BG consists of three physical 
modules: BG, BI, and BJ, which contain the 
control routine, the macro-code 
interpreter, and the built-in: function 
handler, respectively. 


In general, the input to phase BG is the 
set of chained text blocks and dictionary 
blocks created by phase BC. The phase BG 
execution is essentially that of the 
compile-time processor described in the 
external specifications. That is, its 
basic action is to move through text blocks 
looking for instances of compile-time 
variables or compile-time statements, which 
it uses to produce the output text. As 
line numbers are encountered in the text, 
they are placed into a location containing 
the current line number. This is used both 
for phase 8G diagnostics and by the output 
editor. 


If a compile-time variable or procedure 
reference is found, the scan cursor is 
positioned to scan its value. When the 
scan of the value is completed, the cursor 
is properly positioned back into the text. 
If a compile-time variable or procedure 
reference is found in this value scan, 
process repeats itself. 
occur to a depth of 100. 


the 
Such nesting can 


If the scan encounters an encoded 
compile-time statement (built by phase BC), 
control is passed to an interpreter. This 
interpreter executes the statement -- 
possibly repositioning the scan cursor -- 
and returns to the scan. 
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The output of this phase is a PL/I 
source program contained on SYSUT3, and, 
optionally, as a sequenced card deck. 


Phase BM (BO) 


Phase BM examines the heads of the error 
chains in the first dictionary block, and 
programmer options which specify the 
severity level of messages required. If 
there are no messages, it passes control to 
the clean-up phase (BW). If diagnostic 
messages are required, the phase loads BN 
to process\ them after scanning the chains 
and indicating where the text is to be 
found, from the message directory block, 


’ module BO. 


Module BN (BP, BV) 


The text of all compile-time processor 
error messages is kept in modules BP 
through BV. The messages are ordered by 
severity, within these modules. BM will 
have listed those modules which contain 
messages required for a particular pass. 
Module BN loads and releases these modules, 
one at a time and extracts the required 
messages. When all compile-time error 
messages have been processed, module BN 
returns control to BM. 


Phase BW 


The purpose of this phase to set all tables 
and communication region cells to the | 
values required by the compiler proper. In 
addition it will release all text and 
dictionary blocks used by the compile-time 
processor phases and then pass control to 
the next required phase of the compiler. 


If a severe or terminal diagnostic has 
been produced by the Compile-time processor 
a listing of the contents of SYSUT3 will be 
printed (provided that the SOURCE option 
applies), and compilation will be bypassed. 


THE READ-IN LOGICAL PHASE 


The Read-In Logical Phase consists of five 
discrete physical phases, each of which 
processes a particular group of statement 
types. The phase obtains the input text in 
the externally coded form by a call to the 
compiler read routine, and converts it to 


internal code by means of a translation 
table provided by compiler control. 


The source text is scanned for 
syntactical errors. During this time an 
output string is built up, which consists 
essentially of the input text with comments 
and insignificant blanks removed. The 
source text is scanned and statements are 
numbered, identified, and diagnosed. Any 
required substitutions are made, statement 
labels are inserted in the dictionary, and 
chains are formed (for example, BEGIN, 
PROCEDURE chains). If the SOURCE option 
applies, source statements, with their 
number, and optionally, their block levels 
and DO-nest levels, are printed out 
immediately after they have been read. 


When the input text provides an 
end-of-file indication, processing is 
terminated. In ERROR situations this may 
not occur when a valid external procedure 
has been completely processed. By keeping 
a count of PROCEDURE, BEGIN, DO, END, ON, 
and IF statements, the phase can detect 
when the logical end-of-program indication 
is found. If there are more records after 
the end of the external procedure, they are 
ignored. 


If an end-of-file indication is 
encountered before the logical end of the 
program, diagnostic messages are issued and 
suitable END statements are inserted to 
allow compilation to continue. 


The output of the Read-In Phase provides 
a syntactically correct output string; a 
table of entry and statement labels; chains 
of coded diagnostic messages; a set of 
switches specifying compilation content 
details; a set of chains linking statements 
of a particular type, to facilitate 
subsequent scanning; and optionally, a 
listing of the source text. 


Statement Numbering 


All staterents are given a sequential 
number. This includes each compound 
statement, each statement contained ina 
comround statement, block and group 
delimiting statements, and null statements. 
The numbering of the statement is indicated 
on the source listing. Diagnostic messages 
also refer to these statement numbers. 


Statement and Entry Labels 


Statement and entry labels appearing in the 
source text are removed and added to a 
label table, which is built up in the 
region intended for the dictionary. This 
region may be extended by further blocks as 
required. The label table entry is an 
embryo dictionary entry, with blank regions 
to be filled later by the Dictionary Phase 
EG. 


When a label declaration is found, an 
entry is made in the label table with a 
statement label code, the current (updated) 
sequential number, and the current block 
level and block count. 


Statements having multiple labels give 
rise to multiple label table entries. 
These entries are identical except for the 
BCD name. 


If the statement following a label is 
subsequently identified as a PROCEDURE or 
ENTRY statement, the label table is 
re-accessed, and the entries associated 
with the statement are modified (see 
Appendix C.2). 


Chains Constructed by Read-In 


To provide rapid scanning in the dictionary 
phases, the following chains are 
constructed by the Read-In Phase: 


The CALL chain . 
The PROCEDURE-ENTRY-BEGIN chain 
The DECLARE chain 


The ALLOCATE chain 


Errors and Diagnostic Messages 


As the source text is scanned it is 
syntactically analyzed. Keywords are 
identified and passed as valid only if they 
may legally appear within the type of 
statement being diagnosed. However, 
consistency of attributes and options 
within a statement are not normally 
analyzed. This is left for Phase EK. 


When a syntactical error is detected, an 
attempt is made to correct it and an 
appropriate diagnostic message is 
generated. The main aim of the Read-In 
Phase is to present syntactically correct 
text to subsequent compiler phases. 
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Certain corrections are performed without 
prejudicing the complete compilation. 


Detected errors cause a diagnostic 
message to be added to a diagnostic message 
chain in the dictionary area. Each message 
is in a coded form with parameters (textual 
Matter, statement numbers, and so on). The 
message is decoded and printed out by the 
Error Editor. 


Where an error makes it impossible for 
the scan of a statement to continue, the 
Statement is terminated correctly at such a 
point as to leave the statement 
Syntactically correct. The text between 
that point and the next semi-colon (not in 
a comment or character string) is skipped. 
The diagnostic messages produced in these 
circumstances will include at most the 
first ten characters of the text that is 
skipped. 


The Output String 


The output string is so arranged that a 
complete statement never spans storage 
blocks. One of the conditions of a 
successful compilation is that the output 
resulting from any statement must not 
exceed the block. This restriction, 
however, does not apply to DECLARE 
statements. Formats of the statements 
appearing in the output string are given in 
Appendix D.2. 


Identifiers 


All identifiers which are not recognized as 
keywords in the source text appear in the 
output string. 


Constants 


All constants appear in the output string. 


Operators 


All operators appear in the output string. 
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Initial Labels 


Subscripted label variables which are 
initialized by attachment to statements are 
placed in pseudo-assionment statements in 
text, and then handled as if they were 
normal labels. 


STRUCTURE OF THE READ-IN LOGICAL PHASE 


The Read-In Phase can occupy 16K bytes of 
storage for any one pass. A storage map 
for this phase is shown in Figure 5. 


Bytes 
0 [SS a = == 1 
| CA | 
WK f----~--~—----------------------—- 
| cc | 
TK prepreg npn 4 
| cE | cK {| CN | cR | cR | 
8K -------4------4------+------} ------4 
{| ce | cL | co [| cs [| ev | 
12K --—-----4---—---$------ -----}------j 
| cr | cM | cP | cr | cw I 
16K t-----_- eth Se See i Perera y Sere | 


PASS 1 PASS 2 PASS 3 PASS & PASS 5 
Figure 5. Storage Map for the Read-In Phase 


The Read-In Phase consists of five 
phases or passes, each containing at most 
five modules. Modules CA and CC consist of 
common routines which are invoked 
throughout the phase by each of the passes, 
in turn. Modules CE, CK, CN, and CR 
contain separate keyword tables. Details 
of the organization of these tables are 
given in Appendix B. Control for each pass 
resides in modules CI, CL, CO, CS, and CV 
respectively. The following description 
refers to the phases by these names. 


Phase Ci 


During phase CI (the first physical phase 
of the Read-In Phase) the source text is 
read into storage, and character codes are 
converted to an internal form. Statement 
types are identified, labels are inserted 
into the dictionary, and statement 
identifiers are replaced by single-byte 
codes (see Appendix D.1). 


A record is kept of block nesting levels 
and counts to enable a check to be made for 
the logical end-of-program indication. In 
order to do this, certain statements have 
to be either partially or completely 
analyzed in this pass. 


These statements are: 


PROCEDURE-END 
BEGIN-END 
DO-END 
IF-THEN-ELSE 
ON 


If the SOURCE option has been requested, 
a listing of the source program, with the 
statements numbered by the compiler, is 
printed out onto the specified output 
mnedium. 


Phase CL 


The output from phase CI is processed and 
the statement types listed below are 
analyzed in greater detail: 


ENTRY FREE 
PROCEDURE WAIT 
po READ 
Iterative DO WRITE 
RETURN DELETE 
GO TO UNLOCK 
DELAY LOCATE 
DISPLAY REWRITE 


If any errors are detected during this 
pass, diagnostic messages are inserted into 
chains in the dictionary as required. 


Phase Co 


The output from phase CL is processed. In 
particular, the DECLARE, ALLOCATE, and CALL 
statements are analyzed in greater detail. 
The syntax of attributes is checked, but 
their consistency is analyzed during phase 
EK. If the source program does not contain 
any of these three statements, this pass is 
not invoked. 


If any errors are detected during this 
pass, diagnostic messages are inserted into 
chains in the dictionary. 


Phase CS 


The output from phase CL or CO is 
processed. In particular, the syntax of 
input/output statements is analyzed, 
together with the FORMAT statement. If the 
source program contains no input/output 
statements, this pass is not invoked. 


Phase CV 


This phase processes the output from 
earlier phases. In order to assist 
subsequent processing, chains are 
constructed for PROCEDURE, ENTRY, BEGIN, 
CALL, ALLOCATE, and DECLARE statements. 


THE DICTIONARY LOGICAL PHASE 


The Dictionary Phase forms a dictionary of 
identifiers, by first analyzing PROCEDURE, 
BEGIN, DECLARE, and ENTRY statements. The 
text is then scanned for contextual use of 
identifiers, constants, and pictures. 
Finally, every identifier and constant in 
the source text is replaced by a reference 
to its respective dictionary entry. 
Dictionary entries are made during this 
phase for all implicitly defined 
identifiers. The formats of dictionary 
entries appear in Appendix C. 


Constructing and Accessing the Dictionary 


The dictionary, during the construction 
stage, comprises two parts, the hash table 
and the dictionary proper. 


To facilitate a search through the 
dictionary for an entry with a particular 
BCD, a method is used of dividing the 
dictionary into areas. Each area is 
characterized by a property of the BCD of 
each entry in it. In practice, these areas 
are not contiguous but are chained lists, 
each item in the list being one dictionary 
entry long. 


The start of each list is in a table, 
known as the hash table. The association 
of a particular identifier with a list, 
ise. the characterization of an area, is 
achieved by deriving from a given BCD an 
address in the hash table. 


"Hashing" is a process of reducing the 
length of the internal representation of 
the BCD to one word. This is done by 
adding successive four~byte lengths of the 
BCD into one four-byte register. This is 
then divided by 211, and the remainder is 
doubled to give the hash table address 
associated with the particular BCD. All 
identifiers which hash to the same address 
are placed in a chain; in particular, all 
dictionary entries with the same BCD will 
be in the same hash chain. 


If TOM, DICK, and HARRY occur in the 
same DECLARE statement in that order, and 
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they all hash to the same address in the 
hash table, the address in the hash table 
will point to HARRY's entry, which contains 
the address of DICK, which, in turn, 
contains the address of TOM. 


When no further BCD entries are to be 
made in the dictionary, and all BCD 
identifiers in the source text have been 
replaced by dictionary references, the hash 
table is deleted. 


Testing for Consistent Attributes 


A test is made at the start of each list of 
attributes, to ensure that any list of 
attributes at one level of factoring in a 
DECLARE statement is consistent. 


Compiler Pseudo-Variables and Functions 


Expressions specified for array bounds, 
String lengths, and initial value iteration 
factors must be evaluated at object time, 
or at allocation time if the variable is 
controlled. The expressions are placed 
temporarily at the end of the text, and are 
later moved by Phase FV and placed 
immediately following the BEGIN, PROCEDURE 
or ALLOCATE statement to which the declared 
variable belongs. The expression results 
are assigned to pseudo-variables generated 
by the corpiler. These serve two purposes: 
first, the assignment statement appears as 
a normal PL/I statement and need not be 
treated as a special case; secondly, the 
pseudo-variable contains the dictionary 
reference of the variable and information 
concerning the destination of the 
expression. Compiler functions with a 
format similar to the pseudo-variables are 
also created. The function result is the 
specified array bound, or string length. 
Compiler functions are created for two 
purposes: first, to set. bounds for base 
elements of structures when the structure 
bound is an expression, or to set the 
bounds of temporary arrays; and secondly, 
to set the storage address of a dynamically 
defined item immediately before its use. 
The formats of all the compiler 
pseudo-variables and functions appear in 
Appendix D.8. 


Dictionary Entries for Entry Points 


A. PROCEDURE or ENTRY statement may have 
more than one label. Each label must have 
a data description to indicate the type of 
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data returned when the label is invoked as 
a function, and also the type of data to 
which the expression in a RETURN 
(expression) must be converted. These need 
not be the same: there must therefore be 
provision for two data descriptions for 
each label. A PROCEDURE or ENTRY statement 
may specify parameters. The descriptions 
of these identifiers, obtained from DECLARE 
statements or default rules, are used for 
prologue construction, but not for 
parameter matching. Any data description 
given on these statements is to be used for 
conversion at a RETURN (expression), but 
not for determining the result returned by 
a function reference. 


Parameter descriptions for use in 
parameter matching, and data descriptions 
used for determining the type of data 
returned by a function reference, may be 
specified by the source programmer in an 
ENTRY declaration. If these are not given, 


‘default and implicit rules must be used to 


build a data description, but no parameter 
description can be given. 


Given the foregoing requirements, the 
dictionary entries describing an internal 
entry point are as given in Figure 6. 


The set of dictionary entries A, B, C, 
D, E is repeated for each label associated 
with the PROCEDURE or ENTRY statement. The 
entry F will point to entry A for the first 
label only. D will point at the label with 
which it is associated. It should be noted 
that B and C may coincide. 


The entries type 1 for PROCEDURE, ENTRY, 
and BEGIN statements are chained amongst 
themselves in the following way. Each 
entry type 1 belonging to a PROCEDURE or 
BEGIN statement contains the dictionary 
reference of the entry type 1, of the next 
PROCEDURE or BEGIN statement in the source 
program, and also of the entry type 1 of 
the immediately containing block. 


The entries type 1 of PROCEDURE and 
ENTRY statements belonging to a single 
procedure are chained together in a 
circular manner. If there are no ENTRY 
statements the entry type 1 of the 
PROCEDURE statement points at itself. 


External entry points are described by 
dictionary entries termed entry type 4. 
They contain data descriptions of the value 
returned when referenced as a function, and 
may contain descriptions of parameters. 


Formal parameters which are entry points 
are termed entry type 5, and parameter 
descriptions which are entry points and are 
pointed at by types 3, 4, or 5 are termed 
entry type 6. 
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Wote: There is an entry E for each parameter described in D. 


Figure 6. Dictionary Entries for an Internal 


Phase ED 


Phase ED contains a set of subroutines, for 
processing certain of the tasking and list 
processing attributes, and tables of 
generic and non-generic built-in functions. 
The phase obtains 1K of scratch storage, 
into which it moves the routines and 
ables, setting a slot in the 
communications region to point at them. 
This address is later picked up and used by 
phase EL. 


Phase £G (EF) 


Phase EG has two main functions. The first 
is to set up a hash table, and to insert 
the label entries left in the dictionary by 


Entry Point 


the Read-In Phase into hash chains. The 
second function of the phase is to create 
dictionary entries for PROCEDURE, BEGIN, 
and ENTRY statements, and to construct 
chains linking entries of particular types. 


For PROCEDURE-BEGIN statements, entry 
type 1 dictionary entries are created (see 
Appendix C.2), and block header chains are 
set up to link these entries sequentially. 
A containing block chain is also set up to 
link each entry with that of its containing 
block. 


BEGIN statements are scanned for the 
ORDER/REORDER option, and the optimization 
byte is created in the entry type 1 (see 
Appendix C.2). 


On the appearance of PROCEDURE 
statements, circular PROCEDURE-ENTRY chains 
are initialized to link the entry type 1 
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dictionary entries of the PROCEDURE and 
ENTRY statements of the same block. The 
formal parameter list is scanned, and 
formal parameter type 1 entries are created 
and inserted into the hash chain. Details 
of the PROCEDURE-ENTRY chains appear in 
Appendix C.2. 


The attribute list and the options are 
scanned and an options code byte and 
optimization byte are created in the entry 
type 1 (see Appendix C.2). A check is then 
made for invalid and inconsistent 
attributes. CHARACTER and BIT attributes 
are processed, and second file statements 
(see Appendix D.8) are created if 
necessary. Precision data are converted to 
binary, and dictionary entries are created 
for pictures (see Appendix C.7). 


Statement labels are scanned and their 
entry type 2 dictionary entries are 
created. The relevant data bytes in the 
dictionary are completed by default rules 
(see Appendix C.3). 


For ENTRY statements, entry type 1 
dictionary entries are created (see 
Appendix C.2), and the circular 
PROCEDURE~ENTRY chain is extended. Formal 
parameters, attributes, and labels are 
processed in a similar manner to those for 
PROCEDURE statements, except that the 
options code byte is not created. 


| Phase EI (EH, EJ) 


Phase EI scans the chain of DECLARE 
statements set up by the Read-In Phase, and 
modifies the statements to assist Phase EK 
as follows: 


Structure Level Numbers: 


converted to binary. 


these are 


Factored Attributes: parentheses enclosing 
factored attributes are replaced by special 
code bytes, so that Phase EK can 
distinguish them easily. A factored 
attribute table is set up. It consists of 
slots corresponding to each factored level. 
Each slot contains the address of the 
attribute list associated with that level, 
and the address of the slot for the 
containing level. 


The following attributes are processed: 


DIMENSION: dimension table entries (see 
Appendix C.8) are created in the dictionary 
and the source text is replaced by a 
pointer to the entry. Fixed bounds are 
converted to binary and inserted in the 
table. A second file statement (see: 
Appendix D.8) is created at the end of the 
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text, for adjustable bounds, and a pointer 
to the statement is inserted in the 
dimension table. Identifiers with 
identical array bounds share the same 
dimension table. 


PRECISION: precision and scale constants 
are converted to binary. 


INITIAL: dictionary entries are created 
for INITIAL attributes. 


INITIAL CALL: second file statements are 
created for INITIAL CALL attributes. 


CHARACTER and BIT: fixed length constants 
are converted to binary; a code byte marker 
is left for * lengths (see Appendix C.8). 
Second file statements (see Appendix D.8) 
are created for adjustable length 
constants, and the source text is replaced 
by pointers to the statements. 


DEFINED: second file statements (see 
Appendix D.8) are created and the source 
text is replaced by pointers to the 
statements. 


POSITION: the position constant is 
converted to binary. 


PICTURE: a picture table entry (see 
Appendix C.7) is created and inserted into 
the picture chain; similar pictures share 
the same picture table. The source text is 
replaced by a pointer to each entry. 


USES and SETS: USES and SETS attributes 
are moved into dictionary entries, and 
pointers to the entries replace the source 
text. 


LIKE: BCD entries are created for 
identifiers with the LIKE attribute. 


LABEL: if the LABEL attribute has a list 
of statement label constants attached, a 
Single dictionary entry is created. The 
dictionary entry contains the dictionary 
references of the statement label constants 
in the list. 


OFFSET and BASED: Second file statements 
are made and text references are inserted 
in the DECLARE statements for these 
attributes. 


AREA: Fixed-length specifications are 
converted to binary; second file statements 
are made for expressinns; a code byte, 
followed by the length of text reference, 
is inserted in the DECLARE statement text. 





All other attributes, 
constants are skipped. 


identifiers, or 


Phase EL (EK, EM) 


Phase EL, consisting of modules EK, EL, and 
EM, scans the chain of DECLARE statements 
constructed by the Read-In Phase. 


An area of storage known as the 
attribute collection area is reserved. 
This is used to store information about the 
identifiers, and has entries of a similar 
format to that for dictionary entries. 


Complete dictionary entries are 
constructed for every identifier found ina 
DECLARE statement. These identifiers can 
be one of the following types: 


1. Data Items (see Appendix C.4) 


2. Structures (in this case, the 'true' 
level number is calculated) (see 
Appendix C.4) ; 


3. Label Variables (see Appendix C.4) 
4, Files (see Appendix C.7) 

5. Entry Points (see Appendix C.2) 

o. Parameters (see Appendix C.7) 

7. ‘Event Variables 

8. Task Variables. 


Identifiers appearing as multiple 
declarations are rejected and a diagnostic 
message is given. 


The attributes to be associated with 
each identifier are picked up in three 
ways. 


First, the attributes immediately 
following the identifier are stored in the 
attribute collection area. 


Secondly, any factored attributes and 
structure level numbers are examined. 
These are found by using the list of 
addresses placed in scratch storage by 
Phase EI. Each applicable attribute is 
marked in the attribute collection area, 
and any other information, e.g. dimension 
table address, or picture table address, is 
moved into a standard location in the 
attribute collection area. All conflicting 
attributes are rejected and diagnostic 
messages are given. 


Finally, any attributes which are 
required by the identifier, and which have 
not been declared, are obtained from the 
default rules. 


After the dictionary entry has been 
made, furtner processing (e.g. linking of 


chains, etc.) must be done in the 
following cases: 


1. DEFINED data 

2. Data with the LIKE attribute 

3. Files 

4. Strings with adjustable lengths 

5. Arrays having adjustable bounds 

6. GENERIC identifiers 

7. %Structure members 

8. Identifiers with INITIAL CALL 

9. Identifiers with the INITIAL attribute 


After the declaration list has been 
fully scanned and processed, it is erased. 


Phase EP 


Phase EP first conditionally marks later 
phases as ‘wanted‘' or ‘not wanted,‘ 
according to how certain flags in the 
dictionary are set on or off. This assists 
in the load-ahead technique. 


The entry type 1 chain in the dictionary 
is then scanned. For each PROCEDURE entry 
in the chain, each entry label is examined 
for a completed declaration of the type of 
data the entry point will return when 
invoked as a function. If this has 
previously been given in a DECLARE 
statement nothing further is done, 
otherwise entry type 2 and 3 dictionary 
entries are constructed from default rules 
(see Appendix C.2). If this default data 
description does not agree with the 
description derived from the PROCEDURE or 
ENTRY statement, a warning message is 
generated. 


At each PROCEDURE entry, the chain to 
the ENTRY statement entry type 1 is 
followed. Each statement is treated ina 
Similar manner to that for a PROCEDURE 


entry type 1. 


The CALL chain is then scanned and, at 
each point in the chain, the dictionary is 
searched for the identifier being called. 
If the correct one is not found, a 
dictionary entry for an EXTERNAL procedure 
is made (see Appendix C.2), using default 
rules for data description. Before making 
the entry, the identifier is checked for 
agreement with any of the built-in function 
names. If there is agreement, a diagnostic 
message is generated, and a dummy 
dictionary reference is inserted. 
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If an identifier is found, it is 
examined to see if it is an undefined 
formal parameter. If it is, the formal 
parameter is made into an entry point, 
again using default rules for data 
description. If it is not, or if the 
declaration of the formal parameter is 
complete, the type of entry is checked for 
the legality of the call. A diagnostic 
message is generated if the item may not be 
called. In all cases, the item called is 
marked IRREDUCIBLE if it has not previously 
been declared REDUCIBLE. 


Phase EW (EV) 


Phase EW is an optional phase, loaded only 
if any LIKE attributes appear in the source 
program. 


This phase scans the LIKE chain which 
has been constructed by Phase EK, and 
completes the dictionary entry for any 
structure containing a LIKE reference. 
When a structure in the LIKE chain is 
found, its validity is checked, and 
dimension data and inherited information 
are saved. The dictionary is scanned for 
the reference of the “likened" structure 
and the entry is checked for validity. 


This dictionary entry (see Appendix C.4) 
is copied into the dictionary, with 
alterations if there is a difference 
between the original structure and this 
structure with regard to dimensioned data. 
If both structures have dimensions a 
straight copy is made; if the structure 
with the LIKE attribute has dimensions and 
the likened structure has not, the 
dimension information is added to the copy; 
if the structure with the LIKE attribute is 
not dimensioned and the likened structure 
is, then the dimension data is deleted from 
the copy.' Inherited data is added to the 
copy. If an error is found, the structure 
with the LIKE attribute is deleted and a 
base element copy of the master structure 
is inserted instead. Where copies of 
entries occur which refer to dimension 
tables with variable dimensions, the 
dimension table entry is copied, and new 
second file dictionary entries and 
statements are created. Similar entries 
must be made if the structure item has been 
declared to be an adjustable length string, 
or has been declared with the INITIAL 
attribute. 


Finally, the newly completed structure 
is scanned by the ALIGN routine in phase 
EV, to provide correct explicit/inherited/ 
default alignment attributes for its base 
elements. 
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Phase EY 


Phase EY is an optional phase which 
processes all ALLOCATE statements. 


The second file is scanned first and all 
pointers to the dictionary are reversed. 
All ALLOCATE statements using the DECLARE 
chain are then scanned, and the dictionary 
references of allocated items are obtained 
by hashing the respective BCD of each item. 
The attributes given on the ALLOCATE 
statement for an item are collected 
together. 


A copy of the dictionary entry of the 
allocated item is then made (see Appendix 
C.4), and the ALLOCATE statement is set to 
point to it. The dictionary entry is 
completed by including any attributes given 
on the ALLOCATE statement, and copying any 
second file statements from the DECLARE 
chain which are not overriden by the 
ALLOCATE statement. 


In the case of an ALLOCATE statement in 
which a based variable is declared, no copy 
of the original dictionary entry is 
required. The BCD is replaced by the 
original dictionary reference. 


All pointer qualified references in the 
text are checked to determine that the 
qualified variable is based. For every 
occurrence of a variable with a different 


pointer a new dictionary entry is made. If 


the variable is a structure the entire 
structure is copied. A PEXP second file 
statement is made for the pointer and the 
‘defined’ slot in the new dictionary entry 
is set to point to it instead of to the 
declared pointer. 


The BCD of the pointer and the based _ 
variable in the text are replaced by the 
new dictionary reference followed by 
padding of blanks which will be removed by 
phase FA. 


The based variable can be the qualified 
name of a structure member. If this is so, 
the name is checked for validity. Only the 
first part or lowest level of the qualified 
name in the text is replaced by the 
dictionary reference of the member. It is 
preceded by a special marker to tell phase 
FA that a partially replaced name follows. 


Phase FA 


Phase FA scans the text sequentially. If, 
during the scan, qualified names are found 
with subscripts attached, they are 

reordered so that a single subscript list 


appears after the base element name. The 
dictionary is scanned and references 
obtained for any identifiers which are 
contextually, file, event, pointer 
variables, or programmer-named ON 
conditions. If no reference is available, 
a new dictionary entry is made. The 
identifier is then replaced in the text by 
the dictionary reference. 


If a constant marker is found, the 
dictionary is scanned to check if the 
constant is present. If it is not, a new 
dictionary entry is made (see Appendix C.7) 
and the resulting reference replaces the 
constant in the text. 


If a P FORMAT marker is found, the 
dictionary is scanned for a picture entry 
in agreement. If there is no agreeing 
entry, a new dictionary entry is made (see 
Appendix C.7) and the picture chain is 
updated. The dictionary reference replaces 
the format marker in the text. 


The CALL chain is removed from CALL 
statements. The appearance of PROCEDURE, 
BEGIN, END, and DO statements results in 
adjustments to the level and count stacks. 
If statement introduction code bytes appear 
(such as SN, SL, CL, and SN2), the current 
statement number is updated. All data 
items associated with the PROCEDURE, BEGIN, 
ENTRY, and DECLARE statements are removed, 
leaving only the statement identification 
and the keyword. 


Phase FE 


When an identifier is found, the hash chain 
is used to scan the dictionary for a valid 
entry. If one is found, its dictionary 
reference replaces the identifier in the 
output text. If no valid entry is found, 
and the BCD does not agree with any entry 
in the tables of BCDs of PL/I built-in 
functions, then a dictionary entry is made 
as if the identifier was declared in the 
outermost procedure. However, if the BCD 
agrees with a function name, and it is not 
in a SETS position, a function entry is 
made in the dictionary, and its reference 
is used to replace the identifier. 


If a left parenthesis is found, the 
previous dictionary entry is checked for an 
array, function, or pseudo-variable. If it 
is one of these, the relevant marker is 
inserted in the text before the parenthesis 
(see Appendix D.1). 


Checks are also made for the positions 
of function references in assignment 
statements. Any dictionary references 
encountered in the input file are moved 
directly to the output file. 


PROCEDURE, BEGIN, DO, and END statements 
cause the current level count to be 
updated. 


Phase FI 


Phase FI scans the text and checks, where 
possible, the validity of dictionary 
references found. References in a GOTO 
statement are checked that they refer to 
labels or label variables and that the 
subsequent branch is valid. The code byte 
for GOTO is changed to GOOB (see Appendix 
D.1) if the branch is to a label constant 
outside the current PROC or BEGIN block. 
If the branch is to a label variable, GOOB 
is set up unless a label value list was 
given at the declaration, and all members 
of the list lie within the current block. 


List processing based variables in 
ALLOCATE, FREE, READ, WRITE, and LOCATE 
Statements are marked as requiring a Record 
Dope Vector (RDV). Variables in TASK and 
EVENT options on CALL statements are 
checked for validity. 


References are checked if they appear 
where a file is expected. Items in data 
lists are checked for validity, and Data 
Element Descriptors (DEDs) and symbol bits 
are set on for all variables found in the 
lists. 


Any errors which are found cause 
diagnostic messages to be generated and 
dummy references to be placed in the text 
in place of erroneous references. 


Phase FK 


Phase FK scans the attribute collection 
area for entries with the SETS attribute. 
The SETS lists in the dictionary entries 
are scanned, and their syntax checked. 
Identifiers are counted and replaced by 
their dictionary references. Constants are 
counted, converted to binary, and arranged 
in ascending order in the dictionary entry. 


Phase FO 


Phase FO makes a dictionary entry for each 
ON condition mentioned inside a block. For 
ON CHECK conditions multiple dictionary 
entries are made (see Appendix C.7), one 
for each BCD. If a similar condition is 
mentioned more than once in a block, only 
one dictionary entry is made for that 
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condition, except for file conditions, ON 
CONDITION, and ON CHECK, when separate 
dictionary entries are made for each 
different BCD name. 


SIGNAL and REVERT statements are treated 
in a similar manner to ON statements. 


The dictionary entries for each BCD name 
associated with file or CONDITION 
conditions are checked and, if in error, 
the ON, SIGNAL, or REVERT statement is 
replaced by an error statement. A 
diagnostic message is generated. 


The BCD name of each file entry referred 
to in ON, SIGNAL, and REVERT statements is 
examined. If the BCD is SYSIN or SYSPRINT, 
the dictionary reference of the file entry 
is placed in a slot in the communications 
region. 


A check is made to ensure that formal 
parameters do not appear in CHECK and 
NOCHECK lists. A single dictionary entry 
is created for each CHECK and NOCHECK list 
and a pointer to the entry is placed in the 
relevant entry type 1. 


When dictionary entries are made for 
CHECK lists, one of three different check 
codes is used depending on whether the BCD 
is an ENTRY LABEL, a LABEL CONSTANT, or a 
variable. 


List Processing POINTER and OFFSET 
variables in CHECK lists are treated as 
data variables. BASED variables may not 
appear in CHECK lists. 


A dictionary entry is made for the list 
processing AREA condition. This condition 
is always enabled and may not appear ina 
condition prefix. 


Dictionary entries are also created for 
each ON condition which is disabled for a 
particular PROCEDURE or BEGIN block, and 
for each ON condition whose status is 
changed within the block. Pointers to 
these dictionary entries are placed in the 
relevant entry type 1. 


All dictionary entries for ON conditions 
are placed in the AUTOMATIC chain for the 
relevant PROCEDURE or BEGIN block. 


A further, quite distinct, function of 
this phase is to substitute error 
statements for all statements containing 
dummy dictionary references (which have 
been inserted by previous phases on 
detecting a severe error). If a dummy 
reference is found in the second file, the 
compilation is aborted. 


Wherever an element of a label array is 
initialized by appearing as a statement 


38 


label, an assignment to a compiler label 
has been inserted by the Read-In phase. 
Phase FO checks the validity of each such 
assignment; for each array with this type 
of initialization, a second file dictionary 
entry is made, and all assignments to the 
array are chained. 


Phase FQ 


Phase FQ checks the validity of each item 
in the PICTURE chain in the dictionary (see 
Appendix C.7). 


The precision for each correct picture 
is calculated, *ogether with its apparent 
length, and stored in its dictionary entry. 
A data byte is created in the entry for use 
by Phase FT. 


Invalid pictures cause appropriate 
diagnostic messages to be generated. 


Phase FT 


Phase FT performs certain housekeeping 
tasks. These are as follows: 


1. The second file entries are scanned 
and pointers to each entry are 
inserted in the associated dictionary 
entry (see Appendix C.7). 


2. Each item which has a storage class is 
inserted into the appropriate chain 
for that class (see Appendix C.4). 


3. Constants are placed in the constants 
chain and their apparent precision is 
calculated. Sterling constants are 
converted to pence. 


4. Dimension tables are separated for 
items which are not in structures, but 
which are arrays having similar 
bounds, but with different element 
lengths. 


5. Items which are members of structures 
and which have “inherited" dimensions, 
i.e. are contained in a structure 
which itself is dimensioned, are made 
to inherit their dimensions. If a 
base element of a structure inherits 
dimensions which are not constant, 
second file statements (see Appendix 
D.8) are set up to initialize the 
bounds in the object time dope vector. 


6. Items which have expressions to be 
evaluated at prologue time, e.g. 


paranreter descriptions for entry 
points and defined items, are placed 
in the AUTOMATIC chain for the 
appropriate block. 


7. The dictionary entry for any item 
described by a picture is expanded by 
the precision and scale or string 
length, extracted from the picture 
table entry. Identifiers of different 
modes sharing the same picture table 
are now placed in separate tables. 


8. The ‘dope vector required’ bit (see 
Appendix C.5) is set on where 
necessary. 


9. When a label array is found which has 
initial label statements for any of 
its elements, the chained statements 
are meved into the second file. The 
original statement is left in the 
text, to be removed by Phase FV. 


10. Dictionary entries similar to label 
PCD entries are made for all TASK 
variables. 


Phase FV 


Phase FV scans the second file and reverses 
the pointers to the dictionary. 


Dictionary entries for DEFINED data are 
completed (see Appendix C.4 and C.5). 
Overlay and correspondence defining are 
differentiated between, as are static and 
dynamic defining. A preliminary check of 
the validity of defining is also carried 
out. 


When PROCEDURE and BEGIN statements are 
encountered, any second file statements 
associated with data in the AUTOMATIC chain 
for that block are inserted in the text 
following such statements. 


When ALLOCATE statements are found, any 
second file statements associated with the 
item being allocated are inserted in the 
text following the statement. 


When a reference to dynamically defined 
data is found, the base reference is 
inserted into the text following the 
defined reference. 


When an initial label statement is 
encountered in the main text, it is not 
copied intc the output string. 


The dictionary reference of a POINTER in 
a PEXP (pcinter expression) second file 
statement is inserted into the defined slot 
of the associated based variable. If the 


based variable is a structure this 
reference is propagated throughout the 
structure. The PEXP statement is then 
deleted. 


A similar procedure is performed for 
BVEXP (based variable expression) second 
file statements whereby the dictionary 
reference of the AREA is inserted into the 
dictionary entry of the associated OFFSET 
variable. 


ADV second file statements referring to 
a BASED variable are checked for compliance 
with the (F) implementation rules. If the 
rules are obeyed, the dictionary entry of 
the ‘bound variable is inserted in the 
appropriate slot in the multiple table 
entry. 


If an MTF statement refers to a based 
variable the appropriate bound slot is 
copied from one multiple table entry to the 
other. 


Phase FX 


Phase FX is an optional phase entered only 
if the ATR (attribute list) or XREF 
(cross-reference list) option is specified. 
It scans the STATIC, AUTOMATIC, and 
CONTROLLED chains, and the formal parameter 
lists. 


For each identifier it creates an entry 
in text scratch storage of the form: 


2 bytes 3 bytes 3 bytes 
SSS ee Ne en ee ee ee Yc re 
{ Dictionary |Text reference | Text chain | 
| reference jto this item | | 
base eee a eee ee ee ed 


This entry is inserted into a chain of 
similar entries in the alphabetical order 
of the BCD of the identifier. 


If the XREF option is specified, the 
text is scanned for dictionary references. 
When the dictionary reference of an 
identifier is found in the text, an entry 
is created in a chain of entries from the 
dictionary entry of the identifier. If the 
identifier is that of a BASED item, an 
entry is also created in a chain of entries 
from the dictionary entry of the associated 
pointer. 


Each chain member thus represents a text 
reference to an identifier and has the 
form: 


2 bytes 3 bytes 


| Statement number | Text chain | 


t_— +. ~~~ ~~ +4 —- —- + + + - 
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Each reference chain for an identifier 
is in text scratch storage. 


The sorted chain of identifiers is then 
scanned, and for each entry in the chain 
the following actions take place: 


1. The statement number of the DECLARE 
statement, if any, in which the 
identifier was declared is printed 


2. The BCD of the identifier is printed. 


3. If the ATR option is specified, the 
dictionary entry of the. identifier is 
analyzed and its attributes are 
printed. For variables having 
constant dimensions and/or constant 
string lengths, these dimensions and 
lengths are printed. 


Except for file attributes, the 
attributes printed will be those 
obtaining after conflicts have been 
resolved and defaults applied. Since 
the file attribute analysis does not 
take place until after the attribute 
list has been prepared (see Phase GA), 
file attributes in the list are those 
supplied by the programmer, regardless 
of conflicts. 


4. If the XREF option is specified, the 
reference chain for the identifier is 
scanned, and the statement number 
contained in each entry is printed 


Finally, all scratch storage is released 
and control is passed to the Pretransjator 
Phase. 


THE PRETRANSLATOR LOGICAL PHASE 


The purpose of the Pretranslator Phase is 
to expand those statements in the language 
that can be broken down into simpler 
statements, and to insert explicitly 
generated statements in place of implied 
ones. 


Second level markers (see Appendix D.1) 
are removed from internal compiler codes, 
and some of the I/O statements are changed 
into a form more suitable for the 
pseudo-code phase. 


Argument lists are examined and the 
Matching of arguments with parameter 
descriptions takes place, with temporary 
variables being created where necessary, 
e.g., where data conversions are required. 


If the compilation contains ON CHECK 


conditions the appropriate calls to the 
library routine are provided. 
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Any structure assignments containing the 
BY NAME option are processed. 


If any structure assignment statements 
or structures in I/O lists are detected in 
the program, they are expanded into scalar 
assignments and DO groups. 


If the program contains any array 
assignments, or array expressions in I/0 
lists, these are expanded into DO loops and 
scalar assignments or expressions. 


If the program contains iSUB references, 
the subscripts are computed for the base 
array corresponding to the subscripts given 
for the defined array. 


Additions to the Text 


In addition to changing the content of the 
text, the Pretranslator introduces some new 
symbols and grammatical forms into the 
source text. These are as follows: 


The Umbrella Symbol: this is 
designated by the symbol code X‘5E', 
which is used to introduce a literal as 
an operand. It is used only as a bound 
Of a DO loop, or in a call of the dope 
vector pseudo-variable. 


Statements within statements: a list 
of statements may be introduced within 
another statement. In this case the 
inserted list is enclosed in 
parentheses. Statements in the list 
are given no statement number field, 
but they have semi-colons at the end. 


I/O statements: the form of I/0 
statements is changed considerably 
during the pretranslator phases, as © 
explained in the description of Phase 
GB. 


BUY and SELL statements: special 
statements are introduced for 
manipulating temporary storage at 
object time: they have a form similar 
to ALLOCATE and FREE statements. 


Temporary Storage: Pretranslator 
phases create temporary variables for 


function and procedure calls where the 
arguments do not match the final 
parameters, where expressions appear as 
arguments, for control variables for DO 
loops in array and structure 
assignments, and for iSUB defined 
subscript lists. The Pretranslator has 
no mechanism for evaluating 
expressions. Therefore, temporaries 
which have no data type are created for 
expression arguments with no parameter 


description. Such temporaries are 
known as ‘chameleon’ temporaries. 
data type of these chameleon 
temporaries is completed by the 
Translator generic phase when the 
resultant data type of the expression 
has been determined. 


The 


When the Pretranslator creates a 
temporary from an argument which 
contains any array with adjustable 
bounds or adjustable string length, 
compiler functions (see Appendix D.8) 
are generated in-line, to set up the 
adjustable quantities at object time, 
to enable storage of the correct size 
to be acquired by means of the BUY 
statement. 


The temporary variables created by the 
Pretranslator have dictionary entries 
Similar to variables declared in the 
source program, except that the 
temporaries do not have BCD names. 


Phase GA 


Phase GA is an optional phase which scans 
the STATIC chain for file constants and 
OPEN control block entries. 


For file constants a DECLARE control 
block is constructed from the file name and 
attributes, while checking the attributes 
for consistency. For file constants with 
the ENVIRONMENT option a dictionary entry 
is constructed, chained from the file 
constant, containing the storage image of 
the 56-byte DECLARE control block. 


For OPEN control block entries an OPEN 
control block is constructed from the 
attributes in the entry, a check is made 
for consistency, and another dictionary 
entry, chained from the OPEN control block 
entry, is constructed. This new entry 
contains the 8-byte storage image of the 
OPEN control block. 


When the COBOL option is encountered in 
the ENVIRONMENT string of a FILE statement, 
phase GA sets the low-order bit in the 
fifteenth byte of the FILE dictionary 
entry. Although this action overwrites the 
dictionary reference of the ENVIRONMENT 
string, it is permissible since GA is the 
only phase which processes this string. 


The EXCLUSIVE second level marker is 
recognised in the file attribute dictionary 
entry during the diagnostic check and 
construction of the DCLCB or the OCB. 


Phase GB (GC) 


Phase GB, containing Modules GB and GC, 
processes I/O statements. GB removes all 
second level markers from internal 
character codes (see Appendix D.1). It 
then reorders the options so that either 
EDIT, DATA, or LIST options appear last. 


In data lists the DO specification is 
moved so that it precedes the relevant 
list, and the END statement is added. 


In format lists iteration factors are 
expanded. 


RECORD I/O statements for which the 
COBOL file option is recognized are 
examined for validity by GC. Diagnostics 
are put out for LOCATE and READ SET 
statements for which COBOL files are used. 
A temporary variable is created to assist 
such data transfers as occur when a COBOL 
record is read into or written from a 
structure which does not consist entirely 
of one of the followig: 


e doubleword data 

e fullword data 

e halfword binary data 

e character string data 

e aligned bit string data 


e a mixture of character string and 
aligned bit string data 


I/O activity found within a PROCEDURE or 
BEGIN block causes the bit X'10‘' to be set 
to one in the optimization byte of its 
entry type i. 


Phase GK 


Phase GK scans the source text for function 
references. If it finds one, it inserts a 
special marker byte before the argument 
list, followed by: 


1. Two code bytes giving information 
about the type of function, and 
whether it was called with the TASK 
option 

2. The current statement number 

3. The current block level and count 

This phase also inserts a special 


argument marker before each argument in the 
list, followed by the reference of the 
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corresponding parameter and a code byte to 
show whether or not the argument is 
specified in a SETS list. The number of 
arguments present is checked against the 
number given as required by the 
corresponding dictionary entry. 


NULL, NULLO, and EMPTY built-in 
functions are recognised and converted to 
constants. 


Phase GO 


This phase acts as a pre-processor for 
phase GP. 


Phase GP 


Phase GP scans the text for procedure and 
function calls with arguments. These are 
detected by the special markers inserted by 
Phase GK. 


Temporaries (see Appendix C.4) are 
created for any arguments which are 
expressions. (An expression is defined as 
being any sequence of variables and 
Operators, other than single variables 
followed only by a subscript list, or only 
by a defined subscript list and then a 
subscript list). If a parameter 
description has been declared in an entry 
declaration, the temporary which is created 
is of the same type as the parameter 
description. Otherwise, a ‘chameleon' 
temporary of unspecified data type is 
created, its type being subsequently 
completed when the expression type has been 
determined by the Translator generic phase. 


Expressions are scanned for arrays 
(including partially subscripted arrays), 
structures, or the end of the expression, 
in order to determine the highest form of 
aggregate in the expression, so that the 
correct type of temporary may be created. 


Where the expression contains a 
partially subscripted array, a temporary is 
created with a dimensionality equal to the 
number of cross sections specified in the 
subscript list. 


When single arguments are specified 
together with parameter descriptions, the 
arguments are compared with the parameter 
description. If there is a lack of match, 
action may be taken in one of two ways. 


1. If the data types are compatible, a 


warning message is printed, and a 
temporary is created 
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2. If the data types are incompatible, an 
error message is printed, and the 
parameter description is ignored 


When the argument is a single partially 
subscripted array which matches the 
parameter, a special temporary is created 
which has the same dimensionality as the 
number of cross sections in the subscript 
list, and it appears to be defined upon the 
Original argument. Code is then generated 
to initialize the temporaries, multipliers, 
and virtual origin from the dope vector of 
the original argument and the subscript 
list. 


Whenever a temporary is created, a BUY 
Statement contained in nested statement 
brackets is inserted in the output text, 
followed by the assignment of the 
expression or non-matching argument to the 
temporary. After the end of the PROCEDURE 
or function call, all the temporaries 
generated in the call are released by means 
of a SELL statement in nested statement 
brackets. 


In all argument temporaries created by 
phase GP, other than those created for 
constants, a special flag bit is set on 
(see Appendix C.2), but in the case of 
temporaries created for arguments to 
built-in functions, this bit is turned off 
by phase IM. This bit is used in phase QU 
when halfword instructions replace fullword 
instructions in the manipulation of 
halfword binary operands which are 
temporary arquments. 


Temporaries are created for constants 
which are specified as arguments to 
functions defined by the programmer. 


If a TASK, EVENT, or PRIORITY option is 
present in a CALL statement, then any 
temporaries which are created are of the 
*not sold" type. 


If GENERIC entry labels are specified as 
arguments to procedures, a special 
dictionary entry is made which contains the 
argument and parameter description 
dictionary references, to enable the 
Translator generic phase to select the 
correct generic member. 


A warning message is printed whenever a 
temporary is created for an item declared 
in a SETS list. 


When subscript lists for the number of 
cross sections are being checked, a severe 
error message is printed if a subscript 
list contains too many subscripts, and the 
statement is deleted. 


Phase GU 


‘Phase GU scans the source text for 
PROCEDURE, BEGIN, and END statements, and 
for staterents that may raise a possible 
CHECK condition. 


A list of all items currentlv checked is 
extracted from the CHECK and NOCHECK lists 
present in PROCEDURE and BEGIN statements. 


Items contained in statements that may 
raise a CHECK condition are examined and 
compared with the list of currently checked 
items. If the item appears in the list, a 
SIGNAL CHECK statement is created for it, 
either before the statement concerned (for 
labels and entry names) or after it (for 
variables). 


Phase HF 


The purpose of phase HF is to detect 
structure assignment statements, possible 
Structure expressions in data lists in GET 
and PUT statements, and nested statements, 
in particular nested structure assignments. 


The leftmost structure in an expression 
or assignment is used as a basis for 
comparison, and if similar structuring is 
not found throughout the expression or 
assignment, diagnostic messages are issued. 
Any expression containing no structures is 
left unchanged. 


Tre base elements of the structures are 
found, and if the referenced structures are 
dimensioned, a temporary is created for 
each dimension. It is then added to the 
AUTOMATIC chain for the appropriate block. 
Iterative DO loops are constructed, with 
the temporaries iterating between the upper 
and lower bounds of that particular 
dimension. Base elements are assigned, 
with the temporaries as subscripts, and 
with scalars remaining unchanged. END 
statements are created for the DO loops, 
and SELL statements for the temporaries. 
Tne statenents which have been created are 
nested within the original statement. 


Pnase HK 


The purpose of Phase HK is to detect array 
Or scalar assignments, possible array 
expressions in I/O lists in GET and PUT 
statements, and nested statements, in 
particular nested assignment statements. 


The leftmost array in an expression, or 
the leftmost array or scalar in an 
assignment is used as a basis for 
comparison, and if similar dimensions or 
bounds are not found in the array 
references, diagnostic messages are issued. 
Any expression containing only scalars is 
left unchanged. 


For unsubscripted arrays which are 
equally spaced in storage only one 
temporary is bought. For all other arrays 
a temporary is bought for each dimension, 
except in the case of certain partially 
subscripted arrays where the number may be 
minimized. Each temporary will be added to 
the AUTOMATIC chain for the appropriate 
block. If the ON-condition name 
SUBSCRIPTRANGE is enabled for any 
statement, a temporary will be bought for 
each dimension in all cases. Iterative DO 
loops are constructed: for an unsubscripted 
array expression of dimensionality N, the 
temporary will iterate between the lower 
bound of the Nth dimension and an evaluated 
product so that all elements of the array 
are processed; while for other arrays the 
temporaries will iterate between the lower 
and upper bound of the particular dimension 
of the array. The assignment statement is 
added to che output string with additional 
subscripts where necessary. End statements 
are created for the DO loops, and SELL 
statements for the temporaries. The 
statements which have been created are 
nested within the original statement. 


The syntax of pseudo-variables is also 
checked. 


Phase HP 


Phase HP scans the source text for 
references to items defined using iSUBs. 
For each reference found, the subscripts 
are computed for the base array 
corresponding to the subscripts given for 
the defined array. 


The subscripts of the defined -array are 
assigned to temporaries specially created 
for this purpose, which are then used to 
replace the iSUBs in the defining subscript 
list. The base array, with the subscript 
list so formed, replaces the defined array 
in the text. 


THE TRANSLATOR LOGICAL PHASE 


The Translator Phase consists of two 
physical phases, the stacker phase and the 
generic phase. The purpose of the 
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Translator is to convert the output from 
the Pretranslator into a series of 
"triples" (see Appendix D.4). A “triple" 
is in the form of an operator followed 
normally by two operands. 


The translation is achieved by using a 
double stack, with one part for operators, 
and the other part for operands, and 
assigning two weights to each operator. 
One weight (the stack weight) applies to 
the operator while it is in the stack, and 
the other weight (the compare weight) 
applies when the operator is obtained from 
the input stringq. 


When an operator is obtained from the 
input string it is compared with the top 
stack operator. Depending on the result of 
the comparison, one or other of the two 
operators is switched on to determine what 
action is next to be performed. Apart from 
some special cases, this action is usually 
either to continue to fill the stack, or to 
generate a triple. The special cases lead 
to various manipufations of the stack 
items, after which the translation process 
continues. 5 


For the purposes of translation, the 
input text to the translator is considered 
to consist of operators and operands only. 
This means that I/O options, etc., are 
regarded as operators. 


After translation, the text string 
consists of operands and operators. 
statements start with an operator to 
indicate a statement number or label, 
followed by the statement type, which may 
be a single operator, aS in the case of 
RETURN or STOP, or which may be an operator 
such as a function or subscript marker, 
followed by a list of arguments. This list 
may also include compiler generated 
statements, e.g., DO loops for I/O lists. 
All 1/0 options are regarded as operators 
and require no markers before them. The 
end of the source text will be marked by a 
special operator, and compiler generated 
code, which may follow this end-of-program 
marker, will appear between the marker and 
the special second-end-of-program marker. 
The end of a block of text will be marked 
by an EOB overator. The program is now 
assumed to be syntactically correct. 


All 


“phase IA 


Phase IA rearranges the source text into a 
prefix form, in which parentheses and 


statement delimiters have been removed, and 


the operations within a statement have been. 


so arranged that those with the highest 
priority appear first. 
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AS operators and operands are 
encountered, they are stored in stacks. 
Tables give the priority of each operator 
as it appears in the input text and in its 
stack. 


When an operator is found during the 
scan of the source text, its compare weight 
(see Appendix D.4) is tested against the 
stack weight of the top operator in the 
stack. If the compare weight is the lesser 
of the two, then action is taken according 
to the compare operator. This is referred 
to as the compare action. Similarly, if 
the compare weight for the current operator 
found in the scan is greater than or equal 
to the stack weight of the top stack 
operator, action is taken according to the 
top stack operator. This is referred to as 
the stack action. Normally, the compare 
action is to place the compare operator in 
the stack, and to continue the scan, 
placing any subsequent operand in the stack 
until another operator is found. The 
normal stack action is to generate a 
triple, consisting of the top operator in 
the stack and the top two operands, 
eliminating the items from the stack, and 
inserting a special flag as the operand of 
the triple which is now at the top of the 
stack. The source (compare) item is then 
compared with the new top stack item. 


The output text of the stacking phase is 
in the form of a series of triples, i.e. 
statement types with no operands, and 
operators with one or two operands. If the 
result of a triple operation is to be used 
in a later triple, the appropriate result 
is flagged accordingly. 


Certain phases are marked wanted or not 
wanted at this stage. If the source text 
contains an invocation by CALL or function 
reference, Phases IL and IM are marked 
wanted. If it does not, Phases IL, IM, IN, 
IO, IP, I0, MG, MH, MI, MJ, MK, MM, MN, and 
MO are marked not wanted. Phases MB and MC 
are marked wanted when the source text 
contains pseudo-variables or multiple 
assignments; otherwise, they are marked not 
wanted. The DO loop processing phases (LG 
and LH) are marked in co-operation with the 
dynamic initialization phases (LB and LC). 
If LB and LC are requested, the marking of 
LG and LH is left until that stage of 
compilation; otherwise, LG and LH are 
markecd by Phase IA independently. 


When ALLOCATE and FREE statements occur, 
phase NG is marked wanted. When LOCATE 
statements occur, phase NJ is marked 
wanted. 


Phase IG 


Phase IG is an optional phase which is 
loaded to process array and structure 
arguments to built-in functions. When 
aggregate arguments are given for built-in 
functions they are expanded by the 
structure and array assignment phases so 
that the built-in functions appear as base 
elements, subscripted where necessary. 


Phase GP examines these arguments, and 
ascertains whether it is necessary to 
create a dummy. If it is necessary, a 
scalar dummy is created, but the assignment 
of the argument expression is not inserted 
in the text, as this would be an invalid 
aggregate assignment. 


Phase IG examines the text for a BUY 
statement for a dummy for an aggregate 
argument to a built-in function, and then 
inserts an assignment triple in the correct 
place in the text. 


Phase Ik 


This phase immediately precedes the phase 
IL and shares with it the initialization 
processes required by the main generic 
phase IM. It obtains text block storage 
and moves into it routines and a table that 
will be used later by the main qeneric 
phase. Part of the storage is reserved for 
use by the main generic phase as a nested 
function stack area. Control is passed to 
phase IL. : 


Phase IL 


This phase immediately precedes the main 
generic phase IM and completes the 
initialization process begun by phase IK. 
{It obtains 4K bytes of scratch storage and 
places in it the entire built-in function 
table and a list of constants used by the 
|} main generic phase. Registers are set to 
point to the built-in function table, to 
the list of constants, and to the nested 
function stack area reserved by phase IK. 
Further text block storage is obtained for 
use by the main generic phase and a 
register is set to point to it. Control is 
passed to phase IM. 


Phase IM 


This phase is the main generic processor. 
It scans the source text for procedure 
invocations by a CALL statement, procedure 
or library invocations by a function 
reference, and assignments to “chameleon” 
dummy arguments (see Phase GP). 


Any procedure which is generic and is 
invoked by a CALL statement or function 
reference is replaced by the appropriate 
family member. If the invoked procedure is 
non-generic, it is ignored. A generic 
library routine invoked by a function 
reference is also replaced by the 
appropriate family member. 


The arguments passed to library routines 
are checked for number and type, and a 
conversion inserted where necessary and 
possible. 


The type and location of the result of 
all function invocations is placed in the 
text which follows the end of the text 
which invoked the function. The resulting 
type of an expression assigned to a 
"chameleon" dummy is determined and set in 
the dictionary entry which relates to the 
dummy . 


The argument bit, set on for all 
argument temporaries created by phase GP, 
is turned off for arguments of built-in 
functions. 


Phase IT 


Phase IT scans the source text for function 
triples and, in particular, the built-in 
functions for which code will be generated 
in-line. Further tests are made to detect 
the functions which, according to the 
method used to generate in-line code, are 
optimizable. This applies only to the 
SUBSTR, UNSPEC, and INDEX functions. All 
references to ‘chameleon' temporary 
assignments within the scope of these 
functions are removed subject to certain 
restrictions imposed by the function 
nesting situation. 


Phase IX 


Phase IX checks that POINTER and AREA 
references are used as specified by the 
language. This phase is loaded only if 
POINTER or AREA references are found, 
declared either explicitly or contextually. 
Error messages are produced if errors are 
found and the statement in error is erased. 
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Data type triples in the text are 
scanned and a stack of temporary results is 
created containing the values: 


X*'40" for POINTER 
X*°02° for AREA 
K*00" for any other data type 


The maximum permitted number of 
temporeries at any one point in a program 
is 200. The compilation is terminated if 
this figure is exceeded. 


Phase JD 


Phase JD scans the text for concatenation 
and unary prefixed triples with constant 
operands. These are evaluated and the 
results are placed in new dictionary 
entries. The references are passed through 
a stack into the corresponding result slots 
in the text. 


‘THE AGGREGATES LOGICAL PHASE 


The Aggregates Phase consists of three 
physical phases, the preprocessor (phase 
JI), the structure processor (phase JK) and 
the DEFINED chain check (phase JP). 


The structure processor phase carries 
out the mapping of structures and arrays in 
order to align elements on their correct 
storage boundaries. 


The DEFINED chain check ensures that 
items DEFINED on arrays and structures can 
be mapped consistently. 


Phase JI 


The first function of phase JI is to obtain 
scratch storage in which the text skeletons 
contained in phase JJ are to be held. 

Phase JJ is then loaded, and its contents 
are moved to the scratch storage for 
subsequent use by: phases JI and JK. Phase 
JJ is then released and control is returned 
to phase JI. 


The main function of phase JI is to 
expedite data interchange activities. A 
scan of static, automatic, and controlled 
chains is performed. The chains are 
reordered so that all data variables appear 
before non-data items. Adjustable PL/I 
Structures and arrays are detected. Each 
entry in tne COBOL chain is mapped as. far 
as possible at compile-time, removed from 
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the chain, and placed in the appropriate 
AUTOMATIC chain. 


Phase JK 


This phase scans the AUTOMATIC, STATIC, and 
CONTROLLED chains for arrays, structures 
(including COBOL structures), adjustable 
length strings, DEFINED items, AREA, and 
POINTER arrays and structures, TASK and 
EVENT arrays, and TASK and EVENT arrays in 


Structures. 


For the base elements of structures 
without adjustable bounds or string 
lengths, the following calculations are 
made: 


The offset from the start of the major 
structure 


The padding required to align the 
elements on the correct boundary 


All muitipliers of arrays of 
structures. 


For all minor structures and major 
structures the following calculations are 
made: 


Size 


The offset from the preceding alignment 
boundary with the same value as the 
maximum appearing in the structure 


Where a structure contains adjustable 
bounds or string lengths, code is generated 
to call the Library at object time. 


For arrays, the multipliers are 
calculated, unless the array contains 
adjustable items, in which case the Library 
performs the calculations. 


For adjustable structures, arrays, or 
strings, code is generated to add a 
symbolic accumulator register into the 
virtual origin slot of the dope vector, and 
the accumulator register is incremented by 
the size of the item. 


Calculations are made in a similar 
fashion for arrays of strings (in 
structures or otherwise) with the VARYING 
attribute. In addition, code is generated 
to set up an array of string dope vectors 
which refer to the individual strings in 
the array using the dope vector. Code is 
also generated to convert the original dope 


vector to refer to the array of string dope 


vectors, instead of to the storage for the 
array. 


The routine which generates code for 
arrays Of VARYING strings is also used to 
generate code for the initialization of 
arrays of TASK, EVENT, and AREA variables. 


DEFINED items are processed in the 
following way: 


Code is generated to set the 
multipliers and virtual origin address 
of correspondence defined arrays 
without iSUBs in the dope vector of the 
DEFINED items from the defining base 
dope vector. 


Code is generated for overlay DEFINED 
items if they do not fall into the 
class which is to be addressed 
directly. The code first maps the 
DEFINED item, if necessary, calculates 
the address of the start of the storage 
to be used by the DEFINED item, and 
finally, relocates the DEFINED item 
using this address. 


Dope vector descriptor dictionary 
entries and record dope vector dictionary 
entries are made for items which need to be 
mapped at object time, or which appear in 
RECORD-oriented input/output statements. 


Phase JP 


Phase JP scans the DEFINED chain, and 
differentiates between the following: 


1. Correspondence defining 
2. Scalar overlay defining 


3. Undimensioned structure overlay 
defining 


4. Mixed scalar-array-structure-string 
class overlay defining 


In correspondence defining, this phase 
differentiates between arrays of scalars 
and arrays of structures. It also checks 
that the elements of the defined item which 
may validly overlay the elements of the 
hase belong to the same defining class, and 
that the base is contiguous. 


In scalar overlay defining, this phase 
checks that the defined item may validly 
overlay the base. 


For undimensioned structure overlay 
defining, this phase checks that the 
elements of the defined item may validly 
overlay the elements of the base. 


For mixed scalar-array-structure-string 
class overlay defining, this phase checks 


that all elements of the defined item and 
all elements of the base belong to the same 
defining class (bit or character), and that 
the base is contiguous. 


THE OPTIMIZATION LOGICAL PHAS® 


The optimization logical phase consists of 
several physical phases and is loaded if 
OPT=2 is specified in the PARM field of the 
EXEC statement. 


The work done during the Optimization 
Phase can be split into two parts. The 
first consists of testing the text and 
dictionary to see if optimization is 
permissible. As a result of these tests, 
tables are built pointing to optimizable 
text. The second part consists of code 
generation and modification requiring 
scanning of the tables built in the first 
part, and direct references to the text and 
dictionary. 


All code generation resulting in text 
expansion is placed in a patch file, and 
the point of insertion in the text is 
overwritten with a PTCH triple pointing to 
the patch. The last physical phase merges 
the patch text into the main program text. 


Optimized code is produced for subscript 
address calculations and iterative DO-loop 
control. In the case of subscripts most of 
the optimized code consists of reordered 
triples, but optimized loop control code is 
generated as pseudo-code using BXLE, and 
BXH instructions. 


Only simple loops and subscript lists 
are optimized, and the variables involved 
must be real, fixed binary, scalar integers 
and the constants must be decimal integers. 


The two main problems in deciding 
whether it is permissible to optimize code 
are: 


1. Aliasing of variables 


2. The action of the program for 
exceptional conditions 


Optimization is inhibited where it is 
difficult, or impossible, to decide that 
optimization will produce an object program 
which will execute according to the rules 
of PL/I. The keyword REORDER, indicates to 
the Optimization Phase, that ON-units for 
exceptional computational conditions may be 
ignored. This enables more cases to be 
optimized than for the default setting of 
ORDER. 
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Three types of subscript optimization 
are performed: 


1. Transformation Where possible, a 
- control variable used as a subscript 

is transformed such that, instead of a 
‘subscript * multiplier + virtual 
origin’ address calculation, each 
iteration produces a simple increment 
of a register to access the next 
element. 


2. Invariance Where possible, an 
invariant subscript calculation inside 
a DO-loop is moved outside. 


3. Commoning Where possible, a common 
subscript expression is only 
calculated once and this value is 
placed in a register to be used at 
later occurrences. 


For array expressions an attempt is made 
to combine the incrementing of a 
transformed control variable with the BXLE 
or BXH of the optimized loop control code. 


The text is optimized starting from the 
innermost of a nest of iterative DO-loops 
and working outwards. This enables patch 
code, which moves out of a DO-loop, to be 
included in the processing of the enclosing 
DO-loop, hence moving out code as far as 
possible in a nest of loops. 


Phase KA (KB) 


Contains utility routines and common data 
space used by the later optimization 
phases. Details of the utilities are given 
in Appendix K. 


The utilities enable the optimization 
phases to build and process tables in text 
blocks without concern for physical block 
boundaries, status of text blocks, or 
maintaining pointers to first, last, and 
current table entries. 


The facilities provided: 


1. Define a table using a table control 
block area. 


2. Add new entries to the end of a table. 
Table entries may be of fixed or 
varying length and a table can contain 
more than one type. 

3. Scan a table forwards or backwards. 


- &. Make direct reference to table 
elements. 


5. Delete a table. 
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6. Specify locking of entries. 


7. jkRemove all locks on table entries. 


Phase KC 


Phase KC scans the text for DO-loop 
specifications. If the loop is potentially 
optimizable, then any expressions in the 
initial, the TO, or the BY specifications 
are assigned to temporary variables. The 
expression and the assignment are moved 
outside the loop and are replaced in the 
specification by a simple reference to the 
temporary variable. 


Text is also scanned for ON-units. The 
occurrence of each type of ON-unit is 
recorded by the appropriate bit in the mask 
used by Phase KG. 


Phase KE 


Phase KE performs a scan of the dictionary 
and a scan of the text. The purpose of 
these scans is to mark variables ‘unsafe' 
if they can possibly be affected by eae 
to other variables (i.e., aliases). 
Variables are marked unsafe if they are 
EXTERNAL, DEFINED, defined upon, BASED, or 
PARAMETERS, or if they are (or miqht be 
through being arguments of procedure calls’ 
arguments of the ADDR built-in function. 


In addition, during the text scan, the 
DO MAP table is created. This table 
contains an entry for each DO-loop and 
procedure in the source text. Each entry 
contains information describing the loop o 
procedure and giving its location in the 
text. A chain is constructed through thes 
entries giving the order in which they are 
to be processed by subsequent K phases. 


Phase KG 


Phase KG scans the text corresponding to 
each DO MAP entry in turn and builds up tv 
lists which are chained off the DO MAP 
entry. The USE list is a list of all the 
real, fixed binary, scalar integer 
variables which are used within the loop. 
A flag byte indicates whether the variabl: 
is assigned to or is invariant in the loo 


The SUBS/REGION list consists of two 
types of entry: 


1. A SUBS entry which contains the text 


reference of a SUBSCRIPT triple 
referring to an array for which 
SUBSCRIPTRANGE is not enabled. 


2. A REGION entry which contains the text 
reference of a triple which results in 
an assignment to one or more 
variables. There are four types of 
REGION boundaries: 


a. A GLOBAL region boundary which 
contains the text reference of a 
point where the value of any 
variable could be changed. 


b. A PARTIAL SAFE boundary which 
contains the text reference of a 
point where an assignment is made 
to a variable which is a SAFE real 
fixed binary scalar integer, 
followed by the dictionary 
reference of this variable. 


c. A PARTIAL UNSAFE region boundary 
which contains the text reference 
of a point where an assignment is 
made to an UNSAFE variable (not 
just a scalar). The dictionary 
reference is not inserted in this 
case, 


d. An ITDO region boundary which 
contains the text reference of an 
ITDO triple corresponding to an 
enclosed loop. 


Phase KJ 


Phase KJ creates the SUBS TABLE from the 
SUBS/REGION list produced by phase KG. The 
DO MAP created by KE provides the order of 
processing and further information. 


The Region entries from the SUBS/REGION 
list are copied directly into SUBS TABLE 
whenever they occur. The SUBS entries from 
the list are expanded to contain 
information on the type of expression 
involved at this point. The USE list 
created by KG provides information during 
this analysis. The SUBS/REGION list is 
deleted by this phase. 


The iterative specification triples of 
each DO-loop are inspected, and the spare 
operands used to set flaqs to indicate 
whether this loop is optimizable for BXLE 
or BXH loop control code. 


Phase KN 


Phase KN provides initialization of the 
scratch storage area used by nhase KO. 


An initial text scan is made in DO MAP 
sequence, to remove offsets from 
optimizable subscript lists and produce 
hash totals for optimizable subscript 
expressions. The hash totals are placed in 
the SUBS/REGION table and are used in phase 
KO to speed up the matching process. 


Phase KO (KP,kKQ) 


Phase KO processes text in the order 
specified in the DO MAP, i.e., working 
through a nest of iterative DO-loops and 
procedures from innermost outwards. 


The three types of subscript 
optimization: transformation of the control 
variable; invariance; and commoning; are 
performed and optimized code is generated 
and inserted in a patch file. The code to 
be replaced in the original text is 
overwritten with NOP's and a PTCH triple 
points to the patch text. 


All three types of subscript 
optimization require searches for multiple 
occurrences of the same expression in the 
text. This is done by scanning the SUBS 
TABLE for matching triple expressions in 
optimizable subscript lists. When a match 
is found a chain is constructed in the SUBS 
TABLE between the matched elements. The 
code is generated for one chain at a time) 


Code generated for optimized subscripts 
may be inserted: 


1. Before the ITDO triple, i.e., where an 
invariant subscript calculation is 
moved out of a loop or where the 
initial setting of a transformed 
control variable is required. 


2. Before the ITD triple, i.e., for the 
incrementing code of a transformed 
control variable. 


3. After the ITD‘ triple, i.e., the 
DROP's for symbolic registers used in 
the optimized code. 


4. At the point of use in the subscript 
list. 


For array expressions the incrementing code 
for a transformed control variable will be 
deleted if a BXLE or BXH can be generated 
which will increment the transformed 
control variable and control the number of 
iterations of the loop. 
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USSL declarations may be inserted in the 
optimized code to indicate that registers 
have priority and need not be saved and 
restored at branch points. The register 
allccator phase gives these registers 
priority over normal symbolic registers. 


Phase KT 


Phase KT is a renamed replacement of phase 
LA which is now obsolete. It is always 
loaded. This phase is a utility phase 
which remains in storage throughout the 
remainder cf the Optimization Phase and the 
whole of the Pseudo-Code Phase. It 
provides the main scanning routines to 
handle input and output of text containing 
triples and pseudo-code. 


The routine/subroutine directories in 
Charter 3 give a complete list of the 
routines provided, together with brief 
descriptions of their functions. 


Phase KU(KV) 


Phase KU has three main functions performed 
during a single text scan. 


The first function is DO-loop control 
optimization. Each ITDO triple encountered 
during the text scan is checked to 
determine whether or not it has been 
flagged as being optimizable by a previous 
phase. If not flagged the scan is 
continued. All DO-loop control 
specifications headed by an ITDO triple 
flagged as optimizable are replaced in text 
by an optimized pseudo-code group using the 
BXH and BXLE instructions. There are three 
basic forms to this optimized pseudo-code 
control specification, the particular one 
used for any loop depending on the type of 
ster. 


The seccnd function is to detect each of 
the PTCH triples inserted into text by a 
previous phase. The corresponding patches 
are obtained from patch file text blocks 
and are processed as necessary before being 
inserted into text in place of the PTCH 
triple. 


The last function is that of the 
subscript list processing. Each innermost 
subscript list encountered, as indicated by 
the presence of a SUBS triple in the main 
text, is checked for the occurrence of COMA 
or COMR triples within it. The SUBS triple 
is then altered as may be necessary. 
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THE RSEUDO-CODE LOGICAL PHASE 


The Pseudo-Code Phase accepts the output of 
the Translator Phase, and converts the 
triples into a series of machine-like 
instructions. The transformation into 
pseudo-code is achieved by a series of 
passes through the text; each pass removes 
certain triples and replaces them by 
pseudo-code, until the entire text is in 
pseudo-code form. On completion of this 
phasé, control is handed to the Storage 
Allocation Phase. 


Pseudo-Code Design 


Pseudo-code is essentially a one-for-one 
symbolic representation of machine code, 
designed so that it can be transformed 
directly into executable machine code by an 
assembly process. 


Pseudo-code is constructed in basic 
units, the majority of which have a 
standard size of three or five bytes. A 
variable sized unit, however, is also 
available to allow flexibility, its length 
being specified by a length code within the 
unit. The formats of pseudo-code 
instructions are shown in Appendix D.6. 


A unit consists of a one-byte operation 
code followed by normally, a two- or 
four-byte field, or on the other occasions 
by a variable length field. The bit 
pattern of the operation code indicates the 
type of unit which it heads. 


Pseudo-Code Items 


In addition to there being one pseudo-code 
item for each machine instruction which 
could be generated, there are also 
pseudo-code items which are produced to 
convey information from one phase of the 
compiler to another. 


These items of information have the sam 
format as a pseudo-code item, so that the 
handling and scanning of the source text i 
standardized. They do not, however, appea: 
in the final object code. , 


Register Description 


In all cases where a general purpose 
register appears in pseudo-code, it will £ 
described symbolically. When conventional 


registers are required in, for example, 
calling sequences, the registers will be 
referred to physically, as they will be in 
‘all cases of floating-point register usage. 


The Use of Symbolic Unassigned Registers 


Whenever a new register is required while 
pseudo-code is being generated, a symbolic 
register counter is incremented by one and, 
subject to this new value not being greater 
than 16,383, it is used as the symbolic 
name of the required register. When this 
register is no longer required a DROP 
pseudo-code item is inserted into the text 
to indicate to the Register Allocation 
Phase that the physical register allocated 
to this symbolic register may be 
reassigned. 


The Use of Physical Registers 


Physical general purpose registers will be 
used either as arithmetic registers or as 
parameter registers. 


With arithmetic registers, it is the 
responsibility of the pseudo-code 
generation phases to save and restore the 
registers as necessary. This will apply 
both to the general purpose arithmetic 
registers (namely 14 and 15) and to the 
four floating-point registers. Although 
this is of primary interest to the 
expression evaluation phases, it should be 
realised that all phases which generate 
calling sequences must be aware of the 
current status of arithmetic registers, and 
generate code to save and restore them as 
necessary. 


In the case of parameter registers, 
however, the Register Allocation Phase will 
be able to save and restore them as 
required. 


Temporary Descriptors 


As expressions are evaluated, a series of 
intermediate temporary results are 
obtained. These results, or their 
addresses, may be contained in symbolic or 
assigned registers, in a dictionary 
reference, with or without an index 
register, or in workspace. Temporary 
descriptor triples (TMPD) are inserted in 
the text to enable the correct pseudo-code 
instructions to be generated from the 
triples. The format of TMPD triples is 
described in Appendix D.9. 


Temporary Workspace 


A block of temporary workspace is used to 
store intermediate results obtained in 
evaluating expressions at object time. 
Pseudo-code phases allocate the next 
available workspace location within the 
block, and then update the location 
pointer, whenever the necessity to save an 
intermediate result arises. The location 
of the intermediate result is then 
described for later phases by a TMPD in the 
text. Intermediate results are only 
required during the execution of single 
PL/I statements; they are never preserved 
from one statement to another. 


At the end of the pseudo-code phases the 
maximum size of the temporary storage 
required in each PL/I program block is 
placed in a dictionary entry. The required 
amount of workspace is then allocated in 
each Dynamic Storage Area (DSA) by Phase 
PT. 


Phase LB 


Phase LB scans through the text for 
PROCEDURE, BEGIN, and ALLOCATE statement 
triples. 


Whenever one of these is found, a scan 
is made through the immediately succeeding 
second file statements; this is for any IDV 
(initial dope vector) statement referring 
to a variable replication factor in the 
array initial string: Processing of these 
statements and of the corresponding array 
initial strings is then carried out. 


On completion of this secondary scan, 
the action taken depends on which triple 
was originally found: 


1. For PROCEDURE or BEGIN triples, a scan 
is then made of the AUTOMATIC chain in 
the dictionary. For any scalar 
variables that have been declared 
INITIAL, a set of triples is created 
and inserted into the text. For any 
array declared INITIAL, the initial 
string is scanned, and a mixture of 
triples and pseudo-code is generated. 


2. For ALLOCATE triples, if the item has 
been declared INITIAL, the initial 
String is scanned, and a mixture of 
triples and pseudo-code is generated. 


Phase LB also marks Phase LG (DO-groups) 


as wanted or not wanted; this is done in 
co-operation with Phase IA. 
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Phase LD 


Phase LD scans the STATIC chain for any 
variables which have been declared INITIAL. 


When a scalar variable is found, the 
phase constructs two dictionary entries: 
one for the constant, and one for the 
converted constant. 


For arrays, the phase scans the initial 
value string, creating an initialization 
table in the dictionary. Replication 
factors are converted and inserted into the 
table; treatment of the constants is then 
as described for scalar variables. 


Phase OS converts the constants to their 
specified internal form. 


Phase LG 


Phase LG scans the text for DO loops. A 
stack is maintained with each entry 
containing a description of a DO group. 

The stacking reflects the nesting of the DO 
groups. For each DO or iterative DO triple 
a new entry is made at the top of the 
stack. 


BO specification triples are analyzed 
and expressions are assigned to 
temporaries; subscripts in the control 
variable are assigned to binary integer 
temporaries if they are themselves 
variable. At the end of each 
specification, pseudo-code and triples are 
generated to control the loop. 


Triple operators (see Appendix D.4 ) 
peculiar to the specification of DO » LOOPS 
are removed from the text. 


‘For control variables, other than simple 
scalars, text is placed in the DO stack and 
used at every appearance of the control 
variable in the generated text. During 
this time, a scan is also made for 
pseudo-variables, subscripts,. functions, | 
and argument markers. 


Phase LR 


Tne purpose of Phase LR is to save space 
during the expression evaluation phase, LS. 
It provides the initialization for Phase LS 


by obtaining 4,096 bytes of scratch storage — 


and setting stack pointers. The scan phase 
is initialized and Phase MP is marked. 
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The translate table for scanning 
triples, and the constants for expression 
evaluation are included in this phase and 
are moved to the first 1K area of scratch 
storage. Subroutines required by phase LS 
are also moved into scratch storaae at this 


time. Finally, control is passed to Phase 
LS. 
Phase LS 


Phase LS scans the source text to convert 
expression triples to pseudo-code. If a 
triple produces a result, it is added to 
the temporary work stack. 


For the arithmetic triples +,-,*,/,**, 
prefix +, and prefix -, the operands are 
combined to give the base, scale, mode, and 
precision of the result. If conversion is 
necessary, an assignment triple, with the 
target and source types as operands, is 
inserted in the text. In-line pseudo-code 
is generated for all operators except ** 
and some complex type * and / operators. 
In these cases, library calling sequences 
are generated. An intermediate result is 
always produced and the triple is removed 
from the text. 


The operands of comparison triples GT, 
GE, equals, NE, LE, and LT are combined and 
converted as for the arithmetic triples. 
In-line pseudo-code is generated and the 
triple is removed from the text, unless 
both operands are string type, in which 
case a temporary is created. If the next 
triple is a conditional branch, a mask for 
branch-on-false is inserted. Otherwise, 
the result is a length 1 bit string. 


For the string triples CAT, AND, OR, 
NOT, and string comparisons, if an operand 
is zero, TMPD triples, containing the 
intermediate result from the top of the 
stack, are inserted in the text after the 
triple. The result is a CHARACTER or BIT 
string or a compare operator. 


When subscript triples appear, a 
symbolic register number is inserted in the 
triple. The result contains the dictionary 
reference of the array and the symbolic 
register. 


For function triples, a description of 
the workspace for the function result is 
inserted in the TMPD triples which follow 
the function triples. The function result 
is added to the intermediate stack. 


For add, multiply, and divide functions, 


. the function and argument triples are 


removed from tne text. Arithmetic type 
in-line pseudo-code is generated, with 


modifications for the precision and scale 
factor, and the result is added to the 
' intermediate stack. 


With pseudo-variable triples, a special 
marker is added to the intermediate result 
stack. 


Other triples which may use an 
intermediate result, are examined. If an 
operand is zero, two or three TMPD triples, 
containing the intermediate result from the 
top of the stack, are inserted in the text 
after the triple. If both operands are 
zero, the TMPDs for the second operand 
precede those for the first operand. 


Phase LV 


Phase LV provides string handling 
facilities for the pseudo-code phases. 


It converts any type of data item toa 
CHARACTER or BIT string, and an assignment 
triple, with the target and source types 
used as the operands, is inserted in the 
text. 


A string dope vector description is 
produced from a standard string 
description. 


Phase LX (LW, LY) 


Phase LX consists of three modules, LW, LX, 
and LY. Module LW acts as a pre-processor 
for LX and LY, moving constants into 
scratch storage prior to loading the 
string-handling modules. 


Phase LX scans the source text to 
convert string triples to pseudo-code. If 
a result is produced it is added to a stack 
of intermediate string results. 


For the comparison triples GT, GE, 
equals, NE, LE, AND LT, both operands are 
already string type. If one operand is 
zero, the operand is obtained from the 
associated TMPD triples. In-line 
pseudo-code is generated if the operands 
are aligned and are of known lengths less 
than or equal to 255 bytes; otherwise, 
library calling sequences are generated. 
The triple and any TMPD triples are removed 
from the text. 


In the case of the string triples CAT, 
AND, OR, and NOT, the operands are 
converted to string type by phase LV. Zero 
operands are obtained from associated TMPD 
triples. in-line pseudo-code is generated 


when operands are aligned and are of known 
lengths less than or equal to 255 bytes. 
For the CAT operator, the first operand 
must be a multiple of 8 bits unless the 
strings involved are less than or equal to 
32 bits in length. In-line code is also 
generated for the following cases involving 
non-adjustable varying strings: 


1. Character string concatenation of 
varying strings with lengths less than 
256 bytes. 


2. Bit string operations for AND, OR, 
NOT, concatenation, and comparison 
where the strings are aligned and are 
less than 33 bits in length. 


Otherwise, library calling sequences are 
generated. The triple and any TMPD triples 
are removed from the text, and the string 
result is added to the intermediate result 
stack. 


For TMPD triples, if the intermediate 
result described by the TMPD triples is a 
string, a complete string description is 
moved from the top of the intermediate 
stack to the TMPD triples. If the TMPD 
triples do not describe a string, they are 
ignored. 


In-line code is generated for the BOOL 
functions AND, OR, and EXCLUSIVE OR, when 
the third argument is a character or bit 
string constant and the first and second 
arguments are aligned and of known lengths 
less than or equal to 255 bytes. Otherwise 
library calling sequences are generated. 
Subscript and function triples may produce 
intermediate string results. 


Phase MA 


Phase MA generates pseudo-code for both the 
in-line invocations of TRANSLATE and VERIFY 
and for the invocations which call a 
library routine. It is optional depending 
on the presence of the TRANSLATE or VERIFY 
function in the source program. 


Three kinds of tables are handled: 
1. Compile-time created (up to three) 
2. Floating, initialized by in-line code 


3. Floating, initialized by library 
subroutine 


When three constant tables have been . 
created at compile-time, any further 
occurrence of this case, will cause the 
constants of both the second and third 
arguments to be handled via the library. 
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Blocks which have RECURSIVE, TASK, or 
REENTRANT attributes will have their own 
table, otherwise one table will be used for 
many blocks. 


Phase MB 


Phase MB scans the text for pseudo-variable 
markers and multiple assignment markers. A 
stack of pseudo-variable descriptions is 
maintained, together with the left hand 
side descriptions of multiple assignments 
when they occur. . Pseudo-code and triples 
are generated for pseudo-variables and the 
left hand side descriptions of multiple 
assignments are put out in the correct 
sequence. 


Phase MD 


Phase MD uses the SCAN routine to scan the 
text for ADDR and STRING built-in functions 
for which it generates in-line code. It 
appears before the normal function 
processor phase and removes all trace of 
the in-line function. The general SCAN 
routine passes control when these functions 
are found. 


For all cases of ADDR the generated code 
establishes the start address of the 
argument. If structure name arguments are 
present the structure chain is hashed for 
the first base-element. For array names 
the address of the first element is 
calculated. 


If the argument to the STRING function 
is contiguous in main storage, and its 
length is known at compile-time, an 
adjustable string assignment is generated. 
Otherwise the library routines IHESTGA and 
IHESTGB are called to produce the 
concatenated length and to concatenate the 
elements of the array or structure 
argument. 


Phase ME 


Phase ME identifies all invocations of the 
SUBSTR function and pseudo-variable, all 
UNSPEC, STATUS, and COMPLETION functions, 
and those invocations of the INDEX function 
which can be implemented in-line; and 
generates pseudo-code to perform these 
functions at object time. The scan of the 
text is conducted by the general SCAN 
routine, and all trace of the invocations 
of these functions is removed before the 
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normal function processor phase is loaded. 
When the end-of-program marker is 
encountered the terminating routine is 
entered. 


Phase MG 


Phase MG identifies functions which are to 
be coded in-line, and generates, in their 
place, the pseudo-code to perform the 
relevant function. This phase appears 
before the normal function processor phase 
and removes all trace of the in-line 
function. 


The scan of the text is conducted by the 
general SCAN routine, and control is handed 
to the present phase when one of the 
following functions is found: 


ALLOCATION FLOOR BINARY 
BIT IMAG DECIMAL 
CEIL REAL FIXED 
CHAR TRUNC FLOAT 
COMPLEX PRECISION 
CONJG 


Control is also passed to this phase if 
ABS is found with real arguments. The 
arguments are collected, and the 
appropriate routine is entered to generate 
the pseudo-code. When the end-of-program 
marker is encountered the terminating 
routines are entered. 


Phase MI 


Phase MI identifies functions which are to 
be coded in-line, and generates , in their 
place, pseudo-code to perform the relevant 
function. This phase appears before the 
normal function processor phase and removes 
all trace of the in-line function. 


The scan of the text is conducted by the 
general SCAN routine and control is handed 
to the present phase when one of the 
following functions is found: 


MAX 
MIN 


MOD 
ROUND 


If the number of arguments to the MAX or 
MIN functions is greater than three, a 
library call is generated. 


Phase MK 


Phase MK identifies functions which are to 
be coded in-line, and generates, in their 
place, pseudo-code to perform the relevant 
function. This phase appears before the 
normal function processor phase and removes 
all trace of the in-line function. 


The scan of the text is conducted by the 
general SCAN routine, and control is passed 
to the present phase when one of the 
following functions is found: 


DIM HBOUND 

LBOUND SIGN 

LENGTH FREE 
Phase ML 


Phase ML scans the source text for generic 
entry name arguments to procedure 
invocations. 


Such entry names may be floating 
arithmetic built-in functions or 
programmer-supplied procedures with the 
GENERIC attribute. When one is found, the 
correct generic family member to be passed 
is selected by this phase, depending on the 
entry description of the invoked procedure. 


Phase MM 


Phase MM scans through the source text for 
procedure invocations by a CALL statement, 
or for procedure or library routine 
invocations by a function reference. 


Procedure invocations are replaced by an 
external standard calling sequence, and 
library routine invocations are replaced by 
an external or internal standard calling 
sequence aS appropriate (see Appendix 
D.10). 


If a CALL is accompanied by a TASK, 
EVENT, or PRIORITY option, library module 
IHETSA is loaded rather than IdESA, and the 
parameter list is modified to include the 
addresses of the TASK and EVENT variables 
and the relative PRIORITY. 


Phase MP 


Phase MP reorders the BUY and SELL 
Statements involved in obtaining Variable 
Data Areas (VDAsS) for adjustable length 


strings or temporaries, which were created 
by Phase GK. On entering this phase, the 
BUY triples precede the code compiled to 
evaluate the length of storage required for 
the VDA. This evaluation code is included 
between further BUYS and BUY triples, which 
themselves are between the BUY triple being 
considered and its associated SELL triple. 
Phase MP extracts these sections of code 
and places them before the BUY triple of 
the adjustable string temporary. Since 
such BUY triples may be nested, the phase 
maintains a count to record the nesting 
status. 


Phase MS 


Phase MS scans the source text for 
references to subscripted array elements. 


If references are found, pseudo-code is 
generated to calculate the offset of the 
subscripted element in relation to the 
origin of the array. If necessary, further 
pseudo-code is generated to check the 
subscript range. 


Optimization of constant subscript 
evaluation is carried out on arrays having 
subscripts which are integer constants, and 
for which the corresponding dope vector 
multipliers are constant. This applies to 
arrays with fixed-length elements. 


Phase NA 


Phase WA generates pseudo-code for the 
following triples: 


For PROCEOURE' and BEGIN’ triples a 
Library call is generated to the FREEDSA 
routine. 


For RETURN triples a library call is 
generated, unless a value is to be returned 
as the result of a function invocation, in 
which case code is first generated to 
assign the result to the target field, and 
then the library call is made. If the 
function may return the result as more than 
one data type, a switch would have been set 
at the entry point to the function, and the 
RETURN statement would test the switch 
value, so that the data type appropriate to 
the entry point is returned. 


GOTO triples either will be invalid 
branches detected by Phase FI, in which 
case they will be deleted, or they will be 
branches to statement label constants in 
the same PROCEDURE or BEGIN block. In this 
case, they will be compiled as 
one-instruction branches. 
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GOLN triples are compiled into 
one-instruction branches to the compiler 
label number in operand 2 of the triple. 


A GOOB (Go Out Of Block) triple is a 
branch to a label variable, possibly 
subscripted, or to a label in a higher 
block than the current one (a branch to a 
lower block is invalid). A call is 
generated to a library epiloaue routine, 
pointing at a double-word slot containing 
the address of the label and the 
Pseudo-Register Vector (PRV) offset (for a 
label constant), or the invocation count 
(for a label variable). 


STOP and EXIT statements are implemented 
Simply by invocation of the appropriate 
library routine. 


For IF triples, if the second operand is 
an identifier, or the result of an 
expression which is not a comparison, code 
is gencrated to convert it to a BIT string, 
if necessary. This BIT string is compared 
to zero, either in-line, or by a call to 
the library. 


The second operand may be a mask which 
will have been inserted by the expression 
evaluation phase as a result of the 
comparison specified in the IF statement. 
This mask is put into a generated 
instruction to branch if the condition is 
not satisfied, i.e., either to the ELSE 
clause or to the next statement. 


For ON triples, code is generated to set 


flag bits and update the ON-unit address in 
the double-word ON slot in the DSA. 


¥or SIGNAL arithmetic condition triples, 
in-line code is generated to simulate the 
condition. For all other conditions, a 
library error routine is called. 


REVERT triples generate code to set flag 
bits in- the double-word ON slot in the DSA. 


Phase NG 


Phase NG generates the calling sequences to 
the library for DELAY and DISPLAY and WAIT 
statements. 


_ Et generates code to call the library 
routines which handle ALLOCATE and FREE 
statements whose arguments are BASED 
variables. 


For DELAY statements, the argument has 
to be a fixed binary integer, and, if 
necessary, code is generated for 
conversion. 
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For DISPLAY statements, 
be a CHARACTER String, or, if necessary, 
converted to one. A parameter list is 
built up to pass to the library. 


the message must 


For WAIT statements, the parameter list 
is built up in workspace. It consists of 
the address of the scalar expression 
(converted to a fixed binary integer), 
followed by the addresses of the 
event-names that appear in each WAIT 
statement. If the scalar expression option 
does not appear, the address of the total 
number of event-names is used. 


For the tasking option WAIT, whose 
argument is an EVENT array, the phase makes 
a 4-byte entry in the parameter list, 
containing the number of dimensions 
involved, and the address of the EVENT 
array dope vector. If the WAIT statement 
contains an EVENT array and no scalar 
expression, the first byte of the parameter 
list is set to X'FF*. 


For ALLOCATE and FREE statements, with 
based variables as arguments, a parameter 
list is built in workspace before a call is 
made to one of the entry points to IHELSP. 
The parameter list is an 8-byte RDV 
followed by the address of the AREA 
variable from the IN option if present. 


For ALLOCATE, the pointer-variable in 
the SET option is given the value returned 
by IHELSP. 


Phase NJ 


Phase NJ and its supporting block, NK, 
generate the calling sequences to the 
library module for the RECORD-oriented 
input/output statements: DELETE, LOCATE, 
READ, REWRITE, UNLOCK, and WRITE. 


For each of these calls, the information 
contained in the options of the source 
statement is passed by a parameter list, 
constructed as follows: 


DC A(DCLCB) 

DC A(RDV| COUNT | PNTR2 | SDV?) | 0 

DC A(EVENT| LABEL“) | 0 

DC A(SDV.KEYTO|SDV.KEYFROM|SDV. KEY) 10 
DC A(REQUEST_CODES) 


expr in IGNORE (expr) 

pntr in READ SET (pntr) 

SDV of varying string in READ INTO 
(varying string) 

4 Compiler label as result of LOCATE 


WNr 


REQUEST_CODES is a full-word containing 
four control bytes with the following 
meanings: 


Byte 0 Operation code 
00 READ 
04% WRITE 
08 REWRITE 
OC DELETE 
10 LOCATE 
14 UNLOCK 
Byte 1 Group 1 options code 
00 SET 
04 IGNORE 
08 INTO|FROM 
Byte 2 Group 2 options code 
O04 KEYTO 
-08 NOLOCK 
Byte 3 Group 3 options code 


04 VARY INTO 
08 VARY KEYTO 
OC RBOTH 


Note that null arguments in the 
parameter list or REQUEST CODES are 
indicated by zeros. 


Both the parameter list and the 
REQUEST CODES word are constructed in 
STATIC storage. However, if the arqument 
of any of the options refers to AUTOMATIC, 
CONTROLLEB, or BASED storage, the parameter 
list is moved to the workspace storace for 
the statement; the argument is then 
provided just before the library call is 
made. 


In the case of the LOCATE statement, the 
phase is responsible for generating code to 
set the pointer variable with the pointer 
value returned in the first word of the RDV 
by the library. If the PASED variable was 
a structure with a REFER option in an 
extent definition, it is also responsible 
for generating code to initialize the 
extent variable named in the REFER option. 


The DCLCB parameter is taken from the 
FILE option of the statement; the FILE 
option rust be either a file constant or 
file parameter. 


The record dope vector (RDV) is assumed 
to have been constructed hy earlier phases, 
except in the case of CONTROLLED or BASED 
variables or CONTROLLED or BASED 
aggregates, when the procedure is as 
follows: 


1. For CONTROLLED or BASED aggregates, 
Phase NJ creates a library call to 
IHESTRA, passing the following 
arguments through registers: 


Register 1 A(D.V) 
Register 2 A(DVD) 
Register 3 A(RESULT.RDV. SLOT) 


2. For CONTROLLED or BASED strings, the 
phase generates code to construct the 
RDV in the workspace storage of the 
statement, using the dope vector of 
the string. 


The IGNORE expression is taken from the 
IGNORE option of the statement and if 
necessary, converted to an integer. 


The EVENT scalar is taken from the EVENT 
option of the statement. 


The KEYTO SDV is derived from the KEYTO 
option of a READ statement. 


The KEY SDV and KEYFROM SDV are derived 
from their respective options. If 
necessary, they are converted to character 
strinas. 


The PNTR is taken from the SET triple of 
the statement or from the BASED variable of 
the LOCATE triple if no SET triple appears. 


Phase NM 


Phase NM generates the calling sequences to 
the library modules for OPEN, CLOSE, GET, 
and PUT statements. 


For OPEN and CLOSE statements, a 
parameter list is constructed from the 
options given. The options are first 
checked for validity with respect to 
multiple specifications. The arguments on 
the options are checked and converted, if 
necessary, to the correct data type. If no 
file is specified in an OPEN or CLOSE 
statement, it is ignored. The parameter 
lists are as follows: 
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OPEN DC A(DCLCB) 


AtOcsB) 


8 


A(TITLF. SDV) 
ACCIDENT. SDV) 
ACIDENT. DED) 
A(KEYLENGT HA) 
A(LINESIZE) 
A(PAGESIZE) 


CLOSE A(DCLCB) 


5 8 &§ 8 & & SB 


ACIDENT. SDV) 
pC ACIDENT.DED) 


Null arguments are indicated by zero 
address ccnstants. 


_ For GET and PUT statements, the library 
call is in three parts. The . 
initialization, data transmission (Phase 
NU), and the termination. The 
initialization call requires a parameter 
list to be constructed from the given 
options. The options are checked for legal 
combinations and the arguments examined. 


The parameter list when a file is 
specified is : 


Pc ACDCLCB) 
pc A(next statement) 


pC A(binary integer) if SKIP or 
LINE is given. 


For GET and PUT STRING, the argument to 
STRING is checked, and the parameter list 
formed is: 

pc A(SDV of string argument) 
DC A(DED of string argument) 

The termination library call has no 

parameters. As for the initialization, the 


routine used depends on the options given 
in the statement. 


Phase NT 
This phase, which is a preprocessor for 
Phase NU, has two functions: 

1. Initialization of a block of scratch 


storage for use by Phase NU 
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2. Setting up of INCLUDE matrix and 
library routine entries for 
edit-directed, STREAM-oriented I/0 
Statements 


The phase contains all pseudo-code 
skeletons used py Phase NU. 4096 bytes of 
scratch storage are obtained and the 
pseudo-code skeletons are copied into it. 
The address of the scratch area is then 
passed to Phase NU. 


If a flag has been passed from Phase NM, 
indicating the presence of edit-directed 
I/O, a scan of the text is performed. Data 
and format list items encountered during 
the scan are associated as tar as possible, 
and a sufficient set of library modules are 
identified for the edit-directed 
transmission specified in the proaram. The 
INCLUDE matrix is updated and dictionary 
entries ars made for the required library 
format~-director routines. 


Phase NU 


Data/format lists in I/O statements produce 
an internal library calling sequence (see 
Appendix D.10) for each data item and 
format item pair, using registers to point 
at the data item, the data item DED, and 
the FED for the format item. 


Iterations of data items, as .in array 
input or output, and of format items, are 
achieved by making DO loops out of the 
iterations. 


The data items are transmitted serially, 


with program flow going from an item in the 


data list, to the corresponding format item 
and then to the relevant library I/0 
module. On return from the library module, 
control goes to the code for the next data 
item or, in the case of repeated data 
items, to another iteration of the DO loop. 


Remote format statements are executed in 
a similar way. After the R format item is 
met, control is passed directly from the 
data list to the format statement until the 
end of the format statement. Control then 
returns to the item in the in-line format 
code of the EDIT statement following the 
appropriate remote format item. However, 
if no format elements remain but some data 
list elements are still present, control is 
passed back to the beginning of the format 
statement. 


An R format item referring to a label 
which is not attached to a format statement 
will cause an object time error condition 
to be raised, and the execution to 
terminate. 


Phase OB 


Phase OB scans through the text for 
compiler functions and compiler 
pseudo-variables (see Appendix D.8). When 
a compiler function is found, pseudo-code 
is generated to access the operands of the 
compiler functions (e.g., string length, 
array bound), and to place the operand in 
the location specified by the TMPD 
following the function. Assignments to 
compiler pseudo-variables are treated in 
reverse; the result from the TMPD following 
the assignment is stored in the array bound 
or string dope vector slot specified in the 
compiler pseudo-variable. 


Phase OB also scans the text for BUY, 
SELL, and BUY ASSIGN statements. The 
temporary operands of these statements are 
examined, and if they are CAD or short 
fixed-length strings, they are allocated 
the next available workspace offset, and 
the BUY and corresponding SELL statements 
are removed from the text. 


Phase OD 


This phase contains the translate and test 
table used by SCAN, and other tables and 
constants for phase OE. A block of scratch 
storage is obtained into which the tables, 
routines, and constants are moved. A 
pointer to the beginning of this area is 
passed to OE in a register. 


Phase OE 
Phase OE translates the following triples 
into pseudo-code: 

Assignment 

Multiple source assignment 

Multiple target assignment 

ALLOCATE, FREE, BUY, and SELL 


Special assignment 


In-line code is generated for the 
following types of ASSIGNMENT triples: 


1. Floating-point to floating-point 
2. Fixed binary to fixed binary 
3. Fixed decimal to fixed decimal 


4. Numeric field to numeric field, if the 


pictures given for the operands are 
identical 


5. CHARACTER string to CHARACTE? string, 
if the operands are fixed lenath and 
not more than 256 characters 


6. BIT string to BIT string, if the 
operands are aligned and not more than 
2040 bits 


7. Label to label 
8. File constant to file parameter 
9. POINTER/OFFSET to POINTER/OFFSET 


10. FIXED CHARACTER string to VARYING 
CHARACTER string and VARYING CHARACTER 
string to VARYING CHARACTER string 
provided that: 


1. The length of the source operand 
is not greater than 256 bytes 


2. The length of the target string is 
not oreater than 256 bytes, if the 
maximum length of the source 
string is not known. 


3. For FIXED CHARACTER string to 
VARYING CHARACTER string the 
length of the FIXED string is not 
greater than 256 bytes. 


Library calling sequences are compiled 
for those cases Of CHARACTER string to 
CHARACTER string and BIT string to BIT 
string codes not compiled in-line. 


After checking both AREA operands, AREA 
assignments are performed by the library. 


All other assignment triples are 
translated into the CONV pseudo-code macro. 


If the source operand is a constant, the 
type of the target operand is inserted in 
the constant dictionary entry, for 
processing by the constant conversion 
phase, and the assignment is translated 
assuming the target type. 


MULTIPLE ASSIGNMENT triples produce the 
same code as for single assiqnment, except 
that the registers used by the operand 
concerned must not be changed or dropped. 


Library calling sequences are generated 
for ALLOCATE, FREE, BUY, and SELL triples, 
and pseudo-code markers are left in the 
text for insertion of code by Phase QF. 


With SPECIAL ASSIGNMENT triples, if the 
target is a varying or adjustable string, 
storage is obtained if the target is 
AUTOMATIC, or allocated if the target is 
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CONTROLLED. 
translated. 


The assignment is then 


Phase OG (OL) 


Phase OG converts to pseudo-code all 
statement numbers, statement labels, 
PROCEDURE, BEGIN, PROCEDURE’, BEGIN', 
end-of-program triples. 


and 


The CONVERT pseudo-code macro is 
examined in conjunction with the 
OPTIMIZATION parameter and pseudo-code is 
generated in one of three forms: 


1. Code to calli the library conversion 
package 


2. Code to perform the conversion 
"in-line" 


3. A modified CONV macro which is passed 
to phase OM or OP for processing. 
In-line conversion phases which are 
not required (OM and/or OP) are marked 
unwanted. 


IGN pseudo-code items and JMP triples 
are removed. The amount of temporary 
working space required by each block of 
program is calculated and placed in the 
workspace dictionary entry (see Appendix 
C.7). 


The format of the text is converted so 
that a pseudo-code item does not span 
blocks. 


The INCLUDE card matrix is formed for 
all the conversion modules required. 


Phase OM 


Phase OM is called when either optimization 
levels 00 or 01 are specified. This phase 
scans the pseudo-code for the CNVC macros, 
whicn phase OG has placed into the text as 
_28-byte entries containing a transfer 
vector to select the appropriate conversion 
routine within OM, and replaces any such 
Macros with in-line code. 


The conversions inserted by phase OM are 
controlled by phase OG. When OPT=0, 
certain of the simpler FIXED DEC to 
PICTURE, PICTURE to FIXED DEC, and FIXED 
DEC to FIXED BIN conversions are passed to 
OM. When OPT=1, the remainder of the 
feasible FIXED DEC to or from PICTURE and 
FIXED DEC to FIXED BIN conversions are 
passed to OM together with FIXED DEC.to 
CHAR conversions. 
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Certain FIXED DEC to PICTURE 
conversions, which phase OG cannot itself 
efficiently detect to be uneconomic when 
performed in-line, are recognized by phase 
OM, which inserts the calls to the 
appropriate library routines. 


Phase OP 


Phase OP generates in-line code to perform 
BINARY to BIT string, BIT string to BINARY, 
and FLOAT to FIXED BINARY conversions. 


Phase OS 


Phase OS scans through the constant chain 
in the dictionary and converts the 
constants to the required internal form. 
These are then stored in a constants pool, 
and the offset of each constant from the 
Start of the vool is saved in the 
dictionary entry for that constant. 


To permit the correct alignment of the 
constant pool, three scans are made of the 
constant chain; first to convert all double 
word constants, secondly to convert all 
single word constants, and thirdly to 
convert all unaligned constants. 


In the first two scans only one pool 
entry is made for constants having the same 
internal form and value. 


A fourth scan is made of the constant 
chain and all constants required to 
initialize static are converted, but 
instead of inserting these constants in the 
constant pool, they are moved into special 
dictionary entries constructed by Phase LB. 


THE STORAGE ALLOCATION LOGICAL PHASE 


The purpose of the Storage Allocation Phase 
is to ensure that every item requiring 
storage in a PL/I object program obtains a 
unique location of the correct size, 
located on the correct boundary. Items 
requiring storage include PL/I source 
program variables, dope vectors, dope 
vector skeletons, temporary variables, work 
areas, data descriptors, symbol tables, 
addressing slots, register save areas, flag 
areas, etc. Storage locations are 
allocated to items in order of descending 
alignment requirement to avoid wasting 
storace by padding to the required 
alignment. 


The Storage Allocation Phase is also 
responsible for generating prologues. In 
generating the prologues, expressions which 
determine size of variables, code generated 
by the aggregates phase to initialize dope 
vectors, and code generated by the initial 
values phase, must be extracted and placed 
in the correct sequence in the text. Also, 
when a variable depends for its size or 
initial value upon another variable, the 
requests for dynamic storage must be 
arranged so that the dependant variable 
obtains its storage after the variables 
upon which it depends. 


Since all AUTOMATIC and CONTROLLED 
storage is obtained dynamically at object 
time, the Storage Allocation Phase 
generates code to relocate dope vectors 
when the allocated storage address is 
known. 


Phase PA 


The purpose of phase PA is to determine the 
eligibility of the automatic chains of any 
block for STATIC DSAs. Any chain not so 
far found to be ineligible for a STATIC DSA 
is scanned to determine the DSA size. 
STATIC DSAs are generated for any chains of 
less than 512 bytes. 


Dictionary entries are generated for 
STATIC DSAs. This phase also acts as a. 
spill area for routines used in phases PD 
and PH. 


Phase PD 


Phase PD is the first STATIC storage 
allocation phase. It scans the text, and 
for every second file statement encountered 
sets up a pointer in the associated 
dictionary which points to the second file 
statement. It then sorts the STATIC chain 
so that the dictionary entries occur in the 
order in which the storage for their items 
will be allocated. 


Storage is allocated for simple 
non-structured, non-external variables, 
RDVs, DEDs, SAVE/RESTORE entries, and the 
BCD of entry labels and label constants. 
Storage is also allocated for dope vectors 
for all items in the STATIC chain requiring 
them, with the exception of EXTERNAL items. 
A full word address slot is allocated in 
STATIC for each STATIC DSA. 


The external section of the sorted 
STATIC chain is scanned and a 4-byte 
addressing slot is allocated for each entry 


label, label constant, external (entry type 
4) entry, built-in function, or EXTERNAL 
item. For each EXTERNAL item the size of 
the external control section is calculated 
and stored in the dictionary entry. 


The constants chain is scanned and the 
offsets of the storage and dope vectors for 
constants in the constants pool are 
relocated. 


The current size of the STATIC INTERNAL 
control section is computed and the result 
is passed via the communications region to 
the next phase. 


Phase PH 


Phase PH is the second STATIC storage 
allocation phase. It scans the AUTOMATIC 
chain and CONTROLLED chain for all items 
requiring a dope vector. 


For each such item a skeleton dope 
vector dictionary entry is generated in the 
STATIC chain (see Appendix C.7). This 
dictionary entry contains a bit pattern 
equal in length to that of the dope vector 
and containing all those values which are 
known at compilation time. In particular, 
it contains as much of the relative virtual 
origin as is known at compilation time, the 
constant bounds and string lengths, and the 
constant multipliers. 


Skeleton dope vectors are not put into 
the STATIC chain for AUTOMATIC variables in 
any block whose DSA is in STATIC, except 
when the variable dimensions bit is set to 
one. 


If the item is dynamically DEFINED, then 
the dope vector is preceded by one extra 
four-byte slot. (In the case of structures 
there is one extra slot for each element of 
the structure.) If the item is a dynamic 
temporary (temporary type 2) or a 
CONTROLLED scalar string, the virtual 
origin slot is relocated by the length of 
the dope vector. 


In all cases the skeleton dope vector 
dictionary entry is pointed at by the 
dictionary entry of the associated item. 


The sorted STATIC chain is scanned from 
the first skeleton argument list entry. 
For each such entry, space is allocated in 
the STATIC INTERNAL control section 
according to the assembled length of the 
argument list. The offset of each skeleton 
argument list is stored in the OFFSET1 slot 
of the dictionary entry. 
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RDV and DVD entries are found on this 
same scan of the STATIC chain. RDV entries 
are allocated eight bytes; DVD entries are 
allocated the specified length. 


A scan is made of the section of the 
STATIC chain containing STATIC INTERNAL 
arrays. Storage is allocated for each 
array according to its size (computed by 
Phase JK) and the offset of the relative 
virtual origin is relocated to the start of 
the STATIC INTERNAL control section. If 
the array is of the VARYING type and it 
needs a dope vector, then storage is 
allocated for the secondary dope vector. 
The number of elements is calculated for 
INITIAL arrays and stored in the associated 
INITIAL dictionary entry. 


The section of the STATIC chain 
containing STATIC INTERNAL structures is 
scanned. Storage is allocated for each 
structure according to the size of the 
structure (computed by Phase JK), and this 
storage is placed on the correct boundary 
on information supplied by Phase JK. The 
structure member chain for each structure 
is scanned and the relative offset of each 
member is. relocated to the start of the 
STATIC INTERNAL control section. Further, 
on the structure member scan, secondary 
dope vectors are allocated when required, 
and the number of elements is calculated | 
for INITIAL arrays. 


Phase PL 


Phase PL scans the STATIC, AUTOMATIC, 
CONTROLLED, structure, and PROCEDURE block 
chains for variables which require storage 
for their symbol tables and/or data element 
descriptors. 


When a variable is found which requires 
a symbol table, the variable is joined onto 
the chain of symbol variables for the 
particular block. A symbol table 
dictionary entry is created for the 
variable (see Appendix C.7), and a chain is 
set up to and from the dictionary entry for 
the variable. The new dictionary entry is 
joined onto the STATIC chain. 


The size of the symbol table is 
calculated, and its offset from the start 
of the STATIC control section is stored in 
the symbol table dictionary entry. 
Throughout the allocation of STATIC storage 
a location counter is maintained to contain 
the next free location in STATIC; this 
counter is increased appropriately. 


All symbol variables require a DED and a 


branch is taken to the routine which 
allocates them. 
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When a variable is found which requires 
a DED, it is determined whether or not the 
DED describes a standard type; there are 
eight standard types, which consist of the 
different kinds of real coded arithmetic 
data that can be obtained by the 
combination of the attributes FIXED/FLOAT, 
BINARY/DECIMAL, LONG/SHORT (default 
precisions only). 


If the DED is of a standard type, a 
check is made for an identical DED that may 
have already been encountered, so that 
there will be only one allocation of 
storage for any one type of standard DED. 
If the DED is not of a standard type, it is 
allocated storage of its own. 


If the variable does not already have a 
symbol table dictionary entry (which 
contains space for DED information), a DED 
dictionary entry is constructed, and the 
offset of the DED in the STATIC control 
section is stored in it. A pointer in the 
new entry in the dictionary entry for the 
variable is also set up. 


When all data element descriptors and 
symbol tables in the compilation have been 
processed, all STATIC storage has been 
allocated and the total size of the STATIC 
control section is placed in a slot in the 
communications region. 


| Phase PP (PO) 


Phase PP extracts all ON condition entries 
and places them at the head of the 
AUTOMATIC chain. It then extracts all 
temporary variable dictionary entries from 
the AUTOMATIC chain and places them in the 
zone following the ON conditions in the — 
chain. 


All dictionary entries which are totally 
independent of any other variable are 
extracted, and also placed in the zone 
following the ON conditions. 


The phase then extracts all dictionary 
entries which depend upon some other 
variable in containing blocks or in the 
zones already extracted, and places them in 
the next following zone. Dependency 
includes expressions for string lengths, 
expressions for array bounds, expressions 
for INITIAL iteration factors, and defined 
dependencies. This is repeated recursively 
until the end of the chain. If some 
variable depends upon itself, a | warning 
message is issued. 


A special zone delimiter dictionary 
entry is inserted between each zone in the 
AUTOMATIC chain (see Appendix C.7). A code 


-reguiring them. 


byte is initialized in the delimiter to 
indicate to Phases PT and QF whether its 
following zone contains any variables which 
require storage (i.e., it does not consist 
entirely of DEFINED items, which do not 
require storage), and whether or not the 
following zone contains any arrays of 
VARYING strings. 


Phase PT 


Phase PT allocates AUTOMATIC storage, scans 
the CONTROLLED chain, and determines the 
Size of the largest dope vector. It scans 
the entry type 1 chain, and for each 
PROCEDURE block or BEGIN block it allocates 
storage for a DSA and compiles code to 
initialize the DSA. 


A two-word slot in the DSA is allocated 
for each ON condition in the block, and 
code is compiled to initialize the slot. 
Space for the addressing vector and 
workspace in the DSA is also allocated. 


Two words are allowed for tasking 
information in the DSA if the TASK option 
is on the external PROCEDURE of the 
compilation. 


The AUTOMATIC chain is scanned and dope 
vectors are allocated for the items 
Code is compiled to copy 
the skeleton dope vector, and to relocate 
the address in the dope vector. 


Where there is a block with its DSA in 
STATIC, dope vector initialization is not 
performed for the variables in the first 
region of the AUTOMATIC chain. Address 
Slots in dope vectors for variables in the 
remainder of the chain are relocated. 


Storage is allocated for addressing 
temporaries type 2 and for addressing 
controlled variables, and for the 
parameters chained to the entry type 1. 


The first region of the AUTOMATIC chain 
is scanned and storage allocated for double 
precision variables, single precision 
variables, halfword binary variables, 
CHARACTER strings, and BIT strings, in that 
order. 


The first region of the AUTOMATIC chain 
is scanned and storage allocated for 
arrays, relocating the virtual origin. 
arrays of strings with the VARYING 
attribute, the secondary dope vector is 
also allocated and code is compiled to 
initialize the secondary dope vector. 
Correctly aligned storage is allocated for 
structures. If a structure contains any 
arrays of strings with the VARYING 


For 


attribute, the storage for the secondary 
dope vector is allocated at the end of the 
structure. 


A pointer is set up in the AUTOMATIC 
chain delimiter to the second file 
statement which has been created. 


The remaining regions of the AUTOMATIC 
chain are scanned and code is compiled to 
obtain a Variable Data Area (VDA) for each 
region. Code is compiled to copy the 
skeletons into the dope vectors and to 
relocate the addresses in the dope vectors. 
During this pass, any DEFINED items which 
are to be addressed directly have the 
storage offset and the storage class copied 
from the data item specified as the base 
identifier. 


Phase QF 


Phase QF, which constructs prologues, scans 
that text which is in pseudo-code form at 
this time with end-of-text block markers 
inserted. 


When a statement label pseudo-code item 
is found, it is analyzed and one of three 
things happens: 


1. The item is saved if it relates toa 
PROCEDURFEF statement 


2. The item is omitted if it relates to a 
BEGIN or ON block 


3. The item is passed if it relates to 
neither of the first two conditions 


When a BEGIN statement is found, a 
standard prologue of simple form is 
generated, and code is inserted from second 
file statements (if there are any) to get 
the DSA, either dynamically, or in the case 
of eligible bottom-level blocks, by using 
the supplementary LWS made available at 
initialization time. Code is also inserted 
to initialize the DSA and to allocate and 
initialize any VDAs. 


When a PROCEDURE statement is found, it 
is first determined whether it heads an ON 
block or a PROCEDURE block. If it is an ON 
block, a standard prologue (similar to that 
for a BEGIN block) is generated. If it is 
a PROCEDURE block, a specialized prologue 
is generated. This takes account of the 
manner of getting the DSA, the number of 
entry points, the number of entry labels on 
a given entry point, the number of 
parameters on each entry point, and whether 
the PROCEDURE is a function. 
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Prologue code is generated for AUTOMATIC 
scalar TASK, EVENT or AREA variables, in 
order to perform the initialization 
required when these variables are 
allocated. 


The code generated by the prologue 
construction phase is partly in pseudo-code 
and partly in machine code. The machine 
code (which is delimited by special 
pseudo-code items) has the same form as the 
code produced by the Register Allocation 
Phase (see Appendix D.7). 


DSA optimization is performed under 
certain conditions (see Appendix H). 


At the end of the prologue, the 
statement label item saved earlier is 
inserted to mark the apparent entry point. 
Code is produced to effect linkage to BEGIN 
blocks in such a way that general register 
15 contains the address of the entry point, 
and general register 14 contains the 
address of the byte beyond the BEGIN 
epilogue. 


At the end of the text, any text blocks 
that are not needed are freed, and control 
is passed to the next phase. 


Phase QJ 


Phase QJ scans the text for ALLOCATE, FREE, 
and PUY statements. 


On finding an ALLOCATE statement, a 
routine is called which does a ‘look ahead‘ 
for initialization statements associated 
with the allocated variable, e.gq., 
adjustable array bounds or adjustable 
string lengths, and places the text 
references of each statement in the 
dictionary entry associated with each 
statement. 


If the allocated item has a dope vector, 
code is generated to move the skeleton dope 
vector generated by Phase PH into a block 
of workspace in the DSA of the current 
block. 


Any adjustable bound expressions or 
string length expressions are then 
extracted from the text references, and the 
expressions are placed in-line in the text. 


Any information required from previous 
allocations (specified by * in the ALLOCATE 
statement) is extracted from the previous 
allocation, and copied into the workspace. 


Code generated by Phase JK to initialize 


multipliers, etc., is extracted and placed 
in-line, after first loading the variable 
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storage accumulator with the dope vector 
Size. Phase JK generates code to increment 
the accumulator register by the size of the 
item. 


If the item has no adjustable 
parameters, code is generated to increment 
the accumulator by the size calculated at 
compilation time. If this size is greater 
than 4,096, Phase JK generates a constant 
dictionary entry, which is used in this 
code. 


If the item has any arrays of varying 
strings, the size of the array string dope 
vector is added to a second accumulator 
register. Code is generated to add the two 
accumulators into the second one, which is 
a parameter to a library routine. A 
routine is then called which extracts the. 
library call inserted by pseudo-code and 
places it in-line in the text. 


Code is inserted after the library call 
to initialize the dope vector in workspace 
to point to the allocated storage. Code is 
generated to transfer the dope vector from 
the workspace to the allocated storage. 


The code generated by phase JK to 
initialize arrays of varying strings, 
tasks, events, and areas is then inserted 
in the output stream. 


Any initial value statements associated 
with the ALLOCATE statement are extracted 
and placed in-line. The initialization 
statements are then skipped, and the scan 
continues. The last two steps are also 
performed for LOCATE (based variable) and 
ALLOCATE (based variable) statements. 
Action for a BUY statement is similar to an 
ALLOCATE statement, with the following 
exceptions: 


1. Bound and string length code is 
in-line, bracketed between BUYS and 
BUY statements - there is therefore no 
look ahead 


2. There is no initial value code 
associated with temporaries 


3. A slot in the DSA is updated with the 
pointer to the allocated storage for a 


temporary 


The action on encountering a FREE 
statement is to generate code to load a 
parameter register with the pointer to the 
allocated storage for the FREE VDA Library 
call inserted by the pseudo-code. 


Phase QU 


Phase QU scans the pseudo-code text in 
search of instructions which have 
misaligned operands. (A misaligned operand 
has the UNALIGNED attribute and is not 
aligned on the boundary appropriate to its 
data type). When such an instruction is 
found, QU inserts a move character (MVC) 
instruction in the pseudo-code text to move 
the operand to or from an aligned workspace 
area, and substitutes the address of this 
workspace for the operand address in the 
original instruction. If the address of a 
misaligned operand is loaded into a 
register, a note is made of that register. 
QU thereafter treats the instructions which 
refer to it as if they referred to the 
operand itself, by inserting a move 
character instruction, and substituting the 
workspace address for the reference in the 
instruction. 


In handling misaligned operands, phase 
QU uses storage beginning at offset 32 from 
register 9 for its workspace. 


Whenever a load address (LA) instruction 
is found which lies within the calling 
seguence of a library routine and which 
loads the address of a misaligned argument 
of that routine, an aligned workspace 
address is substituted in the instruction, 
and the requisite move character 
instruction is stacked. It is not inserted 
in the output text until the instruction is 
encountered that loads register 15 prior to 
the exit to the library routine, or in the 
case of EDIT-directed I/O routines, until 
the appropriate branch-and-link (BALR) 
instruction is encountered. The stacked 
move character instruction is inserted into 
the output before the exit to the routine 
if the argument in question is an input 
argument to the routine, and after the 
return from the routine if it is an output 
argument. 


Whenever a fixed binary temporary of 
precision < 16 is encountered in the text, 
the dictionary is checked to see if this is 
a member of an argument list (phase GP will 
have set bit). If it is, the instructions 
referring to it are altered to halfword. 
'he displacement in any Load Address 
referring to the temporary is incremented 
by 2. 


References to halfword binary items are 
replaced by halfword instructions where 
PL/I permits. Where possible and 
desirable, fullword instructions are used 
to perform calculations, and only LH/STH 
instructions used to access storage. 


Fullword conversion is inserted into the 
library calls marked by phases LS and NG. 


In handling halfword binary items, phase 
QU uses 4 bytes, beginning at offset 0 from 
register 9, for workspace. « 


Phase QxX 


Phase QX is the ‘AGGREGATE LENGTH TABLE’ 
printing phase. It is entered only if the 
ATR (attribute list) or XREF (cross 
reference list) options are specified. It 
scans the STATIC, AUTOMATIC, CONTROLLED and 
COBOL chains, and, for each major structure 
or non-structured array that is found, an 
entry is printed in the AGGREGATE lenath 
table. 


An AGGREGATE LENGTH TABLE entry consists 
of the source program DECLARE statement 
number, the identifier and the length (in 
bytes) of the aggregate. In the case of a 
CONTROLLED non-BASED aggregate no entry is 
printed for the DECLARE statement, but an 
entry is printed for each ALLOCATE for the 
aggregate, the source program ALLOCATE 
statement number being printed in the 
‘statement number’ column. 


Where the length of an aggregate is not 
known at compilation the word *ADJUSTABLE" 
is printed in the ‘length in bytes‘ column 
of the entry for that aggregate. If an 
aggregate is dynamically defined, the word 
"DEFINED" appears in that column. An entry 
for a COBOL mapped structure (i.e., a 
structure which a COBOL record is read into 
or written from), has the word “(COBOL)” 
appended, but such an entry will appear 
only if the structure does not consist 
entirely of one of the following: 


e doubleword data 

e fullword data 

e halfword binary data 

e character string data 

e aligned bit string data 


e a mixture of character string and 
aligned bit string data 


If a COBOL entry does appear, it is 
additional to the entry for the PL/I mapped 
version of the structure. 


Before printing begins the aggregate 
length table entries are sorted so that the 
identifiers appear in collating sequence 
order. 
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THE REGISTER ALLOCATION LOGICAL PHASE 


* 





The purpose of the Register Allocation 
Phase is to insert into the text the 
appropriate addressing mechanisms for all 
types of storage, and to allocate physical 
general registers where symbolic registers 
are specified or required as base 
registers. 


This phase comprises two physical 
phases, each with a specific function. The 
first, Phase RA, processes the addressing 
mechanisms, while the second phase, Phase 
RF, allocates the physical registers. 


An additional phase kD is called in 
between RA and RF when the optimization 
option is 2 or greater. This pnase 
attempts to optimize the storing and 
loading of registers in use over compiler 
generated branches. 


Phase RA (RB,RC) 


Phase RA scans the text for dictionary 
references, the beginninas and ends of 
PROCEDURE and BEGIN blocks, and the 
Starting points of the original PL/I 
statements. 


A dictionary reference, when found, is 
decoded into a word-aligned dictionary 
address and a code. These are used to 
determine what is being referenced. The 
corresponding object time address as an 
offset and base is then calculated. 


If the address reguired has an offset 
less than 4,096 and a base which is either 
an AUTOMATIC or STATIC data pointer, no 
extra instructions are generated. If this 
is not so, extra instructions are inserted 
in the text stream to calculate the 
required address. The calculation of this 
address is broken down into logical steps 
in a ‘step table.' On completion, the table 
is scanned backwards to determine whether 
an intermediate result has been previously 
calculated. The steps which have not been 
previously calculated are then assembled 
into the pseudo-code. 


The corpiled code is added either to the 
output stream or to a separate file. The 
code in the separate file is terminated by 
a store instruction to save the calculated 
address. The extra “insertion file" is 
placed in the prologue of the relevant 
block by the next phase. Instructions are 
stored in-line if the referenced item is 
CONTROLLED, if it is a oarameter, if fewer 
instructions are required to recalculate 
the base rather than load the stored 
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address, or if the reference itself is in 
the prologue. 


If no addressing code is 
special item is put in text 
RF what base to use. 


generated, a 
to tell phase 


All relevant information 
and BEGIN blocks is stacked 
at the start and end of the 
respectively. 


for PROCEDURE 
and unstacked 
blocks 


At the start of PL/I statements, code is 
compiled to keep the required PREFIX ON 
slots in the Dynamic Storage Area updated. 
On meeting the pseudo-code error marker, 
the calling sequence to the library error 
package is generated, and the error marker 
removed. 


If the STMT option has been specified, 
code is generated at the start of each PL/I 
Statement to keep the statement number slot 
in the current DSA up to date. 


Phase RD 


Phase RD examines all EQUs and determines 
their uses. A table is set up in scratch 
text blocks containing a four-byte slot for 
each EQU. The number of text blocks 
required is calculated from the value in 
the ZMAXEQ field in the’communications 
region. The first text block, containing 
the slots for the first N-4 EQU values 
(where N = text block size), is locked into 
Main storage so that these slots can be ~ 
accessed by direct addressing. 


The other slots are accessed via their 
text references, and their text blocks are 
brought into storage as needed, by the 
compiler control routines. A dictionary of 
text block numbers for, each range of EQU 
values is kept in the phase. This allows 
for a maximum of 64 text blocks, i.e., 
under the smallest SIZE parameter a maximum 
Of 16K EQU values are allowed. 


The table is built up during a pass of 
the program text. At the end of the text 
pass the table is scanned. Any EQU which 
is not used is deleted. Any EQU which is 
either before the first use or used more 
than once is flagged by setting the first 
bit of the EQU value on. During this scan 
of the table, the current table text block 
is locked into storage and released when 
the scan is completed for the block. 


| Phase RF (RG,RH) 


Phase RF scans the text for register 
occurrences, implicit and explicit, and the 
start and end of PROCEDURE and BEGIN 
blocks. At the beginning of PROCEDURE and 
BEGIN blocks all relevant information is 
stacked, and is later unstacked at the 
corresponding end. 


Registers are classified as assigned, 
symbolic, or base. 


Assigned registers require the 
explicitly mentioned register to be used. 
If that register is not free it is stored. 
Symbolic registers may occupy any register 
in the range 1 through 8. An even-odd pair 
may be requested. Base registers may 
occupy any of registers 1 through 8. 


When a register is requested, a table of 
the contents of registers is scanned, to 
determine whether the register already has 
the required value. If it does, that is 
used. If it does not, and it is not an 
assigned register, a search is made for a 
free register and this is allocated if one 
is found. Should no register be free, a 
look-ahead is performed to determine which 
register it is most profitable to free. 


If a register contains a base it need 
not be stored on freeing. If a register 
contains a symbolic or assigned register, 
it may require to be stored when freed, 
depending upon whether it has had its value 
altered since any storage associated with 
it was last referenced. 


At a BALR (Branch and Link) instruction 
it is ensured that all the necessary 
parameter registers are in physical 
registers, and not in storage. 


No flow trace is carried out by the 
compiler. Therefore, the register status 
is made zero at branch-in and branch-out 
points. An exception is at a conditional 
branch. Were the registers are not freed 
after having been Saved. 


Any coded addressing instructions are 
expanded when found in-line. At a specific 
“insertion point” in a prologue, any 
addressing instructions in the “insertion 
file" are krought in and expanded. 


THE FINAL ASSEMBLY LOGICAL PHASE 


The Final Assembly Phase converts the 
pseudo-code output of the register 
allocation phase into machine code, the 
principal functions being the substitution 


of machine operation codes for pseudo-code 
operations, and the replacement of PL/I and 
compiler inserted symbolic labels by offset 
values. 


Loader text is generated for program 
instructions, DECLARE control blocks, and 
OPEN file control blocks, initial values 
defined in the source program, parameter 
lists, skeleton dope vectors, symbol 
tables, etc. ESD and RLD cards are 
generated for external names and 
pseudo-registers. An object listing of the 
code generated by the compiler is produced 
if the option has been specified by the 
source programmer. 


Phase TF 


Phase TF scans the text, assigns offsets to 
compiler and statement labels, and 
determines the code required for 
instructions which reference labels. 


The size of each procedure is determined 
and stored in the PROCEDURE entry type 1. 
A location counter of machine instructions 
is also maintained. 


Phase TJ 


Phase TJ scans the text until no further 
optimization can be achieved in the final 
assembly. 


A location counter is maintained for 
assembled code, and offsets are assigned to 
labels. 


The size of each procedure is determined 
and stored in the PROCEDURE entry type 1. 
The amount of code required for 
instructions to reference labels is also 
determined, while attempting to reduce this 
from the amount estimated by the first 
assembly pass. 


This phase also attempts to reduce the 
number of Move (MVC) instructions by 
searching for consecutive MVC instructions 
which refer to contiguous locations... 


Phase TO (TQ) 


Phase TO sets the four byte slot ZPRNAM, in 
the communication region, to contain the 
first four characters of the first entry 
label of the external_procedure, for the 
purpose of object deck serialization. 
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Phase TO also produces ESD cards for the 
compiled program. It first makes up six 
standard entries for: 


1. Program Control Section (CSECT) (SD 
type) allowing room for the compiler 
subroutines if these are present. 


2. STATIC internal CSECT (SD type) 
3. Invocation count (PR type) 


4. Entry points to library routines, 
IHESADA and IHESADB (ER type) 


5. IHEQERR (PR) 


6. IHEQTIC (PR) 


If the external procedure has the MAIN 
option, an entry for a one-word CSECT (SD 
type) is made up. An entry is made for the 
CSECT 1H entry and entries are made up for 
all entry labels in the external procedure 
(LD type). 


The entry type 1 chain is scanned and an 
entry (PR type) is made up for each block 
and procedure. 


The external section of the STATIC chain 
is scanned and entries are made up for: 


1. Built-in functions and library 
functions (ER type) 


2. Files (ER type) 
3. STATIC external variables (SD type) 
4. External entry names (ER type) 


5. Programmer ON condition names (SD 
type) 


The CONTROLLED chain is scanned and an 
entry is made up for each CONTROLLED 
variable and task name (PR type). 


The size of the program control section 
is incremented to include the compiler 
subroutines. 


All STATIC DSAs are put into the STATIC 
INTERNAL control section, their combined 
Sizes being allowed for when the size of 
the CSECT is calculated. 


Module TQ is used to produce a list of 
library conversion routines required for 
execution of the program. ER type entries 
are made up for each name in the list. 


68 


Phase TT 


Phase TT scans the text and maintains a 
location counter for assembled code. 


Loader text (TXT) and relocation 
directory (RLD) cards for requested 
combinations of load and punch files are 
generated. 


Nested procedures are unnested at object 
time by suitable manipulation of the 
location counter. The offset of each 
procedure from the start of text is left in 
the PROCEDURE entry type 1. 


Compiler labels are numbered for use by 
the object listing phase, and trace 
information is set up at entry points. 
Phase TT also generates the text for the 
compiler subroutines. These subroutines 
are put out in one of the following 
combinations: 


1. EPILOGUE subroutine 
DYNAMIC PROLOGUE subroutine 
STATIC PROLOGUE subroutine 


2. EPILOGUE subroutine 
DYNAMIC PROLOGUE subroutine 


3. EPILOGUE subroutine 
STATIC PROLOGUE subroutine 


Phase UA 


Phase UA generates text for the static 
internal CSECT; initializes a CSECT for 
each static external variable; and, 
optionally (if the LIST option is present), 
lists all the text produced for the static 
internal CSECT and provides suitable 
comments. 


The phase first scans to the start of 
the external section of the STATIC chain, 
generating text for entry labels, label 
constants, compiler labels, file 
attributes, label variable BCDs, and DEDs 
for temporaries. Simple variables found on 
this scan are used, together with the 
labels, to mark the start of the character 
string section of the chain. 


The phase then scans to the end of the 
external section of the chain, initializing 
address constants for external variables, 
external entry names, built-in and library 
functions, programmer-defined ON-condition 
names, external files, and label constants. 
Text is made up for the constants pool. 


The third scan of the STATIC chain 
starts at the point left by the previous 


scan, and generates text for dope vector 
skeletons, argument lists, RDVs and DVDs, 
and symbol tables. The scan is terminated 
at the end of the chain. 


Phase UA makes up RLD cards for the 
address slots for STATIC DSA‘s and for the 
address slot of the start of the epilogue 
subroutine, if generated. 


Text cards are output to initialize all 
AREA'S, EVENT's, and TASK's. Arrays of 
AREA's, will have a text card for each 
element. 


Phase UD 


Phase UD generates RLD and TXT cards to set 
up dope vectors at link-edit and load time. 


TXT cards are generated for each STATIC 
DSA, containing its length, which is found 
in the STATIC DSA entry. 


TXT and RLD cards are generated to set 
up the dope vectors for structured items 
and any non-structured items appearing in 
the AUTOMATIC chains. The TXT cards are 
derived from the skeleton dope vector 
entries. The RLD cards are generated for 
each virtual origin slot. 


When the last STATIC DSA has been 
processed control is released from phase 
UD. 


Phase UE 


Phase UE initializes those items on the 
STATIC chain not processed by Phase UA. 


The phase first scans to the start of 
the external section of the chain, making 
up text for simple data, and listing label 
variables. 


The second scan starts at the head of 
the character string section of the chain, 
and initializes dope vectors for all static 
internal variables which need then. 


The third scan corresponds in extent to 
the third scan in Phase UA, but generates 
text for arrays, and simple and interleaved 
structures. At the end of this scan, a < 
test is made to determine whether the 
external procedure of the program has the 
MAIN option. If so, a one-word CSECT 
(IHEMAIN) is made up, to contain the 
address of the principal entry point to the 
compilation. 


The phase then executes its final scan, 
which extends over the external section of 
the chain, to initialize a CSECT for each 
external variable or external file. 


Finally, any incomplete text and RLD 
cards are punched out, and an END card is 
produced for the compiled program. If the 
OBJNM parameter is present for batch 
compilation, phase UD punches a NAME card 
to follow the END card. 


Phase UF (UH) 


Phase UF scans the text, and lists, in 
assembly language format, machine 
instructions compiled for the source 
program. It inserts comments in the 
listing for statement numbers, statement 
labels, entry points, prologues, and 
procedure bases. 


Phase UF contains module UH which 
generates NAME from a dictionary reference. 
UF also lists the text for the compiler 
subroutine. This is done by releasing UH 


. and loading module UI which performs this 


function. Upon termination of this phase 
module UI passes control to phase XA. 


THE ERROR EDITOR LOGICAL PHASE 


The Error Editor Phase is entered at the 
end of all compilations. The first phase, 
Phase XA, examines the dictionary and 
determines whether there are any messages 
to be printed out. If there are none, this 
phase terminates the compilation. If there 
are diagnostic messages to be printed out, 
phase XB is loaded and the third section of 
the phase directory is completed. Phase Xc 
is then loaded and this together with phase 
XA causes further modules (XF, and blocks 
XG to YY) to be loaded, which process the 
error dictionary entries and print out the 
appropriate messages. 


Phase XA 


Phase XA examines the heads of the error 
chains in the first dictionary block, and 
the programmer options which specify the 
severity level of messages required. If 
there are no diagnostic messages to be 
printed, this phase prints out a completion 
message and completes the compilation. If 
diagnostic messages are required, the phase 
loads module XB which completes the phase 
directory for Compiler Control. Phase XB 
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is then released and phase XC and the 
message address block XF are loaded. 


The error editor then scans down the 
error message chains and marks each error 
dictionary entry with an indication of 
where the associated message is to be 
found. This information is obtained from a 
table in module XF. 


The text of all error messages is kept 
in modules XG through YY. The messages are 
ordered, by severity, within these modules. 
Module XA will have listed those modules 
which contain messages required for a 
particular compilation. Module XC loads 
and releases these modules, one at a time, 
and extracts the required messages. Having 
loaded a particular module, the phase scans 
down the associated error message chain in 
the dictionary for error entries associated 


70 


with the module. It accesses the error 
message text and scans it. 


The message to be printed is built up in 
a print buffer in internal compiler. code. 
This involves a translation from EBCDIC 
mode, which is used for the message text 
skeleton. The message is completed by the 
insertion of a statement number, an 
identifier, or a numeric value as specified 
by the message dictionary entry. The 
message is segmented, where necessary, to 
avoid spilling over a print line, 
translated to external code, and finally 
printed out. 


When all error message dictionary 
entries have been processed, module XB 
returns control to phase XA, which passes 
control to module AA for termination of the 
compilation. 


CHAPTER 3: FLOWCHARTS, TABLES, AND ROUTINE DIRECTORIES 


Note: For descriptions of terms and 
abbreviations used in the text during a 
compilation which are mentioned in this 
chapter, refer to Appendix D.11. 


This chapter provides a complete guide 
to the compiler logic, in the form of 
flowcharts and associated tables and 
routine directories, arranged in phase 
order. 


Flowcharts 


The flowcharts are presented at three 
levels of detail -- overall, logical phase, 
and physical phase. The overall compiler 
flowchart (Chart 00) points to the logical 
phase flowcharts (Charts 01 through 11), 
each of which appears at the head of the 
set of physical phase flowcharts to which 
it points. The physical phase flowcharts 
point (by means of identifiers placed next 
to the blocks) to the various routines 
used. Entry points to physical phases are 
labeled. 


Where transfer is effected between 
modules within a physical phase, the entry 
label into the entered module is shown as 
follows: 


41. Where the means of transfer is a 
transfer vector, an asterisk is shown 
as the label on the flowchart, and a 
note at the foot of the chart states 
that the transfer vector table is 
located at the start of the module. 


2. When transfer is made from a decision 
block, the block representing the entry 
is labeled. 


With the exception of “fall-through" 
branches, all branches from decision blocks 
are labeled where possible. Where the 
branch is actually a branch table, this 
fact is indicated on the chart, and the 
label of the. branch table is given. 


In some cases, additional labels have 
been given, to assist in following the 
program flow. 


Tables and Routine Directories 


For each physical phase, a table is 
provided, which lists the operations 
performed and identifies the routines and 
subroutines involved. Where applicable, a 
routine directory follows the table. This 
provides an alphanumerically arranged list 
of the routines and subroutines contained 
in the phase, and states their function. 


In some cases, a physical phase 
comprises more than one module; this means 
that routines contained in different 
modules may be listed together in one 
routine directory. To assist in 
cross-reference to the compiler listings, 
the following convention has been adopted: 
if a routine is contained in a module whose 
label is not identical to that of the phase 
under discussion, the label of the 
containing module is inserted in 
parentheses after the routine name in the 
directory. 


In the case of a phase sharing a routine 
contained in another phase, the label of 
the containing module is indicated in 
parentheses after the routine name in the 
"Subroutines Used" column. The routine 
will not then appear in the routine 
directory for the phase under discussion, 
but will be found in the routine directory 
for the containing phase. 


Chart and Table Identification 


Identification of tables and physical 
phase flowcharts is based on the phase 
label. 
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e Chart 00. Overall Compiler Flowchart 
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COMPILER CONTROL PERFORMS IWITIALIZATIO, 
OVERSEES PHASE ofghetis RESOLVES “BYREO LEE 
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@Chart AA. 





Resident Control Phase Logic Diagram (Modules AA through AM, and JZ) 
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Table AA. Module AA Compiler Control Resident Control Phase 


See re Re ee Te ee ee ee Te ee eee ee ae hee an 
| |Main Processing | | 
| Statement or Operation Type | Routine | Routine Called | 
po-~~-- == = = - === === = - === f= =f === === === === == 4 
Initializes the compiler | ZINIT |LOADW, ABORT 


| | | 
|Parameters passed: General register 1 points at| | 
{the passed parameters | | 

| 


{Entry to the operating system: GETMAIN(R), | 
|TIME, LINK, SPIE | | 


a a ef a ef ne + + 


{Deletes a list of loaded phases | RELESE | ZUERR, ABORT 


| | | 
|Parameters passed: PAR1 -- address of list of | | 
|phases to be deleted | | 

| 


[Entry to the operating system: DELETE | 


calle eee cee eee cece ee he eee owe ee es ee 


{Deletes a list of loaded phases and passes | RLSCTL |Module AD if inter- 
jcontrol to either the next requested phase or | |phase dumping is req- 
jthe next named phase | juired; Module AE if it 
| | jis end of Read-In 
|Parameters passed: PARI -- address of list of | |Phase; ZUERR, ABORT 
[phases to be deleted; PAR2 -- address of name _ | 
jof phase to which control is to be given, or | 
| zero | 
| Parameters returned: PARI -- load point of new | 
|phase — | 
jEntry to the operating system: DELETE, | 
| LOAD(EPLOC), LOAD(DE), LINK | 
{Loads the required phase and returns control to|LOADX | ZOERR, ABORT 
|the caller. The phase may be loaded again | 
| 
|Pazameters passed: PAR1 -- address of name of | 
|phase to be loaded | 
j|Parameters returned: PAR1 -~ load point of | 
| 
| 


re US eee eee ee 
hee cme ee ees eee aes em comes mee cee ee come 


| phase 
jEntry to the operating system: LOAD(DE) 


| 

| | 

| | 

| | 

| | 

| | 

| | 

| , 

{Marks phases as ‘wanted’ and ‘not wanted’ | REQEST | ZUERR, ABORT | 
| | 
|Parameters passed: PAR1 -- address of | 
[list of phase names to be marked ‘wanted;'‘ | 
|PAR2 -- address of list of phase names to be | 
|marked ‘not wanted’ | 
| 

1 


jEntry to the operating system: None 


[Puts a record out to SYSLIN 


| record 
{Entry to the operating system: PUT LOCATE(QSAM) 


}-}----------~-—--- - - --- -- - - -- - - a ee ee es ce ee ee te ee ee ee oe hs ee ee ee ee ee we a ee 


|Puts a record out to SYSPUNCH 


| 
| Parameters passed: PAR1 -- address of output 
|xecord 


| Entry to the operating system: PUT LOCATE(QSAM) 


| 
! 
| 
| 
| 
| 
+ 
| | 
{Parameters passed: PAR1 -- address of output | 
| 
| 
4 
| 
| 
| 
| 
Hl 


eae ae ma a an nen ee en an em aera eee ——— 
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Table AA. Module AA Compiler Control Resident Control Phase (cont'd) 


SS a ee en ee t= ee ee er ee ee en ee 7 
| , |Main Processing] | 
| Statement or Operation Type | Routine |Routine Called | 
ann nn nn nn nnn nnn nnn nn nn nnn nf in nnn nnn nnn nnn nnn | 
|Deletes currently loaded phases and passes |ZABORT, ABORT |Module AD if dump op- 


jcontrol to the Error Editor | 


| 
jEntry to the operating system: LOAD(EPLOC) if {| 
|dump option specified | 


jtion specified; RLSCTL 


hee ne eee eee ee wee hee ee eee oe ee oe 


| 
| 
| 
aa ann enn nnn = fn }---------~------------- 
[Picks up completion code and returns control to|ZEND | ZUPL 
{the program that called compiler { | 
| | | 
|Entry to the operating system: TIME, FREEMAIN, | | 
| DELETE | | 
SP RD AS AD AD PT AS A SPAS AS AS Ae AS PAS AS OS La LS PCN eatsetath <aie ee —---—--- — --- -~- -—-- $ ---- wane” a a? ana a> eae an a ee oe oe ee ee er ee ee ee ee a a ee Oe ee ee ee 
jHandles all program checks | PIH | ZOERR | 
| | | | 
{Parameters passed: ARINT holds address of | | | 
|routine wanting to handle interrupt. ARMASK | | | 
Jholds mask indicating which interrupts it is | | | 
{desired to handle | | | 
| | | | 
{Entry to the operating system: None { | | 
CLO ANR AEECE  S O ST  EEE [NEE eee ae SOREN Pm NEST LN a SON Pe Se eee ie SOON SEEPS OY 
Table AAI. Module AA Routine/Subroutine Directory 
a re a ge ape rg pease ce go NE a pre Tam ee ge 
| Routine/Subroutine | Function | 
| ABORT |Deletes currently loaded phases, passes control to error editor. | 
| | 
{BLKERR © jEnters message "REFERENCED BLOCK NOT IN USE", then terminates | 
| | compilation. | 
| { | 
| CONSLD |Takes dictionary reference and points at relevant slot in dictionary| 
| Jcontrol block area (DSLOTS). | 
| | | 
|CONSLT |Takes text reference and points at relevant slot in text block | 
| {control area (TSLOTS). | 
\ 4 
| DFREE |Finds dictionary block which can be written on disk to make room for| 
| ja new block in storage. | 
| | 
| LFERRX |Marks error on SYSLIN data set. | 
| | | 
| LOADX |Loads required phase and returns control to caller. The phase may | 
| jbe loaded again. | 
{ | 
| LOADW |Loads required phase and returns control to caller. | 
{ | 
| PIE {Handles all program checks. | 
| | eae cata ot 
| PLERRX {Prints record on SYSPRINT data set. Pagination (paging action) is | 
| |performed automatically. 
{ | 
| RDERRX |Marks error on SYSIN data set. ! 
| | 
| READX |Reads a block from disk. 
\ | 
| RELESE {Releases all loaded phases. | 
{ 
|] REQEST {Marks phases as ‘wanted’ or ‘not wanted.‘ 
| | : 
| RLSCTL [Releases all loaded phases and passes control to next required or 
J 


|mamed phase. 


| 
eae ei ae ee ee i a ee 


Table AA1. Module AA Routine/Subroutine Directory (cont'd) 


[Routine/Subroutine| + Punction | 
[SPERRX +~~«*([Marks error on SYSPUNCH data set. = = 
| ZABORT |Deletes currently loaded phases and passes control to error editor. 

ZEND {Picks up the completion code for the compilation and returns control 


| 
| {to ZINT to continue the batch, or to the operating system at the end 
| jof a single or batch compilation. 


| 
| ZINIT j|Initializes the compiler. 


ee a ee eee ee ee cee cee ee wee eee cee cee eee 


| 
| ZULF . |Puts record out to SYSLIN data set. 
| 
| ZUSP |Puts record on to SYSPUNCH data set. 
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Table AB. Module AB Compiler Control Initialization 


Grr ty eee a ee na RN A a mn age ae ahaa ie aeainn Gobeieienataanebeteateeietan: | Pa eee Or ey te nen eee ere ey 


, |Main Processing| | 


| Statement or Operation Type | Routine | Routine Called | 
po~-~ =~ = nn nn nnn nnn === == f= == == 
{Issues a BLDL macro instruction on all phases’ |PROPEN | None 
jin compiler, and constructs a compacted phase 


i 
JEntry to the operating system: BLDL 


|Prints initial heading and performs scan of | OPTPROC 
Joption list. Default options are taken where | 
|necessary | 

| 


|Parameters passed: General register 1 points to| 
Joption List passed at invocation time 


|Enlry to the operating system: TIME, 
{PUT LOCATE (QSAM) 


{Makes the initial space allocation for text and] OPENR | None 
{dictionary blocks. Sets up communication { | 
{region 


| 
| dictionary | 
| 
| 


None 


ce cs ee re ee of ee ee 


j : 
|Entry to the operating system: GETMAIN(R) 
k 


JOpens spill file if text and GkeOre ey blocks | OPENSP 
jare 1K | 


| . : | 
[Entry to the operating system: OPEN | | 


tO GP cute ct ED CED ae EP ae ee ee ee Se ee os ee ee ee ee en ee ee ee ee 2 eee oe oe a eee ee eee aa es Sa ---—---—-—}——--- - - - -- 
{Obtains the guaranteed 4K of scratch storage | GETSCR | None 


{ 
|Entry to the operating system: GETMAIN(R) 


ee ES A A SY SA SE A AE AS OS SS A SS SD SE SD SY SS SA SU SD SE SS SS ED OS A SD SE OD GE i GS GES ES GD SAS GS OS SD Oe GED cee ee ee ee 


| 
. ~---}--—-~----------}----------------------- 
|Loads intermediate file writer (Module AC). | NODUMP 
Jsets buffer sizes for SYSUT3 and opens the data] 
jset | 

I 

| 

\ 


| 
[Entry to the operating system: LOAD(EPLOC), 
| OPEN 

{Prints out list of options for this compilation| NDMP 
J 


| 
[Entry to the operating system: None | 


jEnters error messages generated when SYSIN, | Pd13 : | ZUERR (AA) | 
|SYSPRINT opened 


ZUPL (AA) 


| 
{Entry to the operating system: None 


{Reads first card and stores. Uses as heading 
{if required 


ZURD, ZUERR, ZUPL | 
(all in AA) | 


! 
! 
t 
! 
j 
| 
| 
| 
l 
! 
! 
! 
! 
! 
! 
1 
! 
' 
! 
| 
! 
abe 


ani 
| 
| 
| 
| 
H 
| 
| 
| 
| 
| 
| 
| 
| 
H 
| 
| 
| 
| 
| 


jReturn to pre-initializer in IFMAA | ABOUT | None | 
jOpens SYSPUNCH if MACDCK specified | MCD | ZOERR | 
| | | i 
|Entry to the operating system: OPEN | | | 


a a fn rf ne ener ere me a 
esas dictionary handling control routines | LODCNTL | None 
| (phase IEMAN or ILEMAL depending on normal 
|dictionary or extended dictionary being 
{specified in the options) 


| 
| 
| 
| 
| 
| 
4 


| 
| 
| 
| . \ 
{Entry to the operating system: LOAD . ae 


a a a n  — ee ee ee oe we b ee re ee er ee 


Table AB1. Module AB Routine/Subroutine Directory 


| Routine/Subroutine | Function | 
lapour. SSS [Returns control to pre-initializer in moaule MA. 
| GETSCR ispeadas scratch storage. ! 
| NDMP |Prints lists of options for current compilation. | 
| NODUMP [Loads intermediate file writer module AC. Sets buffer sizes for 
| |SYSUT3 and opens data set. | 
oBeWH |Makes initial space allocation for text and dictionary blocks. sees 
| [up communications region. | 
: OBENBE lanai spill file. 
\epapeos lecines initial heading and performs scan of option list. | 
aoe ieee diagnostic messages generated when SYSIN and SYSPRINT data | 
| [sets are opened. | 
ieeepen | Issues BLDL Macro instruction and constructs phase directory. ! 
|RDCD ead first card. 


ca es See as Sa es es et cee re eteews CEO kee, EE aS SS TE A AE OE DR sete SE eee A RS See EG GE A ee ere ants cha i cy ee eg ED et Ec A ce 


Table AC. Wodule AC Compiler Control Intermediate File Control 

a ia ee eae ng ae i eae ge eg ae, To ee re er ee 1 
| . {Main Processing| 

| Statement or Operation Type | Routine | Routine Called f 


pram nnn nn nn nn nnn nnn fn nnn nnn np nnn nn enn nnn nna 
{Writes a record onto SYSUT3 | TEMAC | None 


| | 
{Parameters passeji: PAR1 -- address of output | 


| 
| | 
: | | 
|xrecord; PAR2 -- length of record | [ | 
{Entry to the operating system: PUT LOCATE(QSAM) | | | 
}---~-=~==——=---—- SITS vUDUEINDEND UD EnANINEPPUDUE=ne inane eeneneneie ae $o—~-----~-------—---——- { 
{Link to file switching routine (Module AG) | ENDED | None | 
{ | | | 
jEntry to the operating system: LINK | | | 
beee seo eee eo ee ore eee ee eee a ease eee ee ee a ee oe 
Table AD. Module AD Compiler Control Interphase Dumping 
ray ene ne ae ee en Ine ea ee yee ee rr ee eee ’ 
| {Main Processing| 
| Statement or Operation Type | Routine ] Routine Used | 
i aa a aa a ec nln ee ae a tl aa 4--—---~-----—----}-~--~---~-~--+..--.--.-- 
{Debugging aids. This routine contains a dump- | IEMAD |ZDRFAB, ZTXTAB, ZUPL | 
Jing program which is invoked by use of the DUMP| {| (allo in AA), | 
joption - | | DUMP | 
ee arate eee neo a a i Oa a cl a ea RS a ca cae aa aa SSE Reese nee alee ERAN VRE ENON ROy ee J 
Table AD1. Module AD Routine/Subroutine Directory 
ep Ey ee ee em ee ee eee ee ee ee “7 
jRoutine/Subroutine | Function | 
}~----------------- }-----------------------------------------------------------=-------- { 
| DUMP |Converts contents of specified area of main storage to hexadecimal, | 


| [prints the result. 
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Table AE. Module AE Compiler Control Clean-Up Phase 


| - |Main Processing] 


[text and four dictionary, if running with the | | 
{44k size option | | 
| | | 
{Entry to the operating system: GETMAIN | | 


; | 
| Statement or Operation Type | Routine | Routine Called | 
ee SLES LS EE SS ES A SE A SS SS SS eS A A SS ee SE ee SS SS aD ee ee ee ee ie ae ee ee ee ee ee oe ee oe oa ee 4 eas a ae aw eae eed centr CD OD CED GP GED cer te ett ene 
[Input and intermediate file control. Current |IEMAC | None : 
{input file is closed and IEMAC is deleted if | (Module Ac) | | 
|present | | | 

| | | 
{Entry to the operating system: CLOSE(current | | | 
| input file), DELETE | | { 
~---~~-------------—--------------------—---- }~--------------}~~--------------------- 
{Opens SYSLIN and SYSPUNCH data sets if required|NOT4&8 |ZUERR (AA) | 
\ | | | 
jEntry to the operating system: OPEN | | | 
nn nn rn rn rn rn en en nn fae pn en nn nnn fn nn en a |] 
[Expands the number of blocks in storage to four|NOTDCK | None | 
| 

| 

| 

| 

z) 


Table AE1. Module AE Routine/Subroutine Directory 


| koutine/Subroutine | Function | 
~--------—------- }--------------------------------------------------------- ----—-------4 
[NOTES |Qpens SYSLIN and SYSPUNCH data sets as required. | 
| | 

| NOTDCK {Expands number of blocks in storage. | 
foto eee Sees Peso eee aaa eee oe ee eee oe eee eee eee J 


Table AF. Module AF Compiler Control Sysgen Options 


a a a ca RR Tg a ae a Sa, a a a i 1 
| Function | Subroutines | 
Peet ede Ree a eee oa en ee ee ei See eae lee eee are ee 4 
|This module contains no executable instructions. It is | None | 
|generated at SYSGEN time and passes the default options | | 
jand values to the compiler | | 
Loe ieee eee awe ae em aso eR eae eo ee i ag a aaa Siena See ee ened 


Table AG. Module AG Compiler Control Intermediate File Switching 


ye a Oe eg ee pe a pe ae ee ee ee pate he age ee oe a 1 
| Function | Subroutines, | 
aa nn nnn nnn a nn nnn nnn nnn nnn nnn | 
|Switches SYSUT3 from an output file to an input file | None | 
| | | 
| Entries to the operating system: OPEN and CLOSE | | 
a rs a ne a a i a a nas hse ee eee 
Table AK. Module AK Compiler Control Closing Phase 
Fe ee en ee ee re ee te 1 
{ Function | Subroutines | 
[SD AD TE ORS ST SUS A Ee SS ES EE ED ED ED EP GD ED ETE DD ee Se a ee ee CE ee EE ee ae a ae ee ee ee ee eer ae ae aa ae en ee | 
[Closes files, frees scratch core and deletes unwanted | ZURC(AA) | 


| phases 
[If batch compiling, scans batch delimiter card for correct 
|syntax and updates completion code. 


{DELETE, and FREEMAIN | 


be ee te ee ame One CERES enn ane ane Ee a ae ee ae ee ee on aman Fee ate ee ENE Oe SRE MNT RL, [ate Nee Raa e AR ae an ES eM eae EEN Neat Ra 


| 

{ 

| | 

| | 

| | | 
|Entries to the operating system: TIME, CLOSE, FREEPOOL, | 
Jj 
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Table AL/AN. Modules AL/AN Extended Dictionary/Dictionary Phases 


| |Main Processing] Routine Called | 
! Statement or Operation Type | Routine i | 
|Releases scratch storage allocated by 2UGC | ZURC | ZUERR, ABORT : 
| 
| Parameters passed: PAR1 -- a count of the | { 
| number of entries to ZUGC to be released | | | 
| Entry to the operating system: FREEMAIN if | | | 
| storage being replaced is outside the guaran- | | | 
| teed 4K block | | | 
[Inserts diagnostic message in the dictionary | ZUERR |ZDRFAB, ZDICRF, ZDICAB i 
| | 
| Parameters passed: PAR5S -- numeric parameter | | ! 
| (if any); PAR6 -~ message number; PAR7 -- add-| | | 
| ress of text (if any) or dictionary reference | | | 
{ (if any); PAR8 -- length of text (if any) | | | 
| Entry to the operating system: None | | | 
a a a a nnn fe ef ne e+ eee 
|Takes a dictionary reference and points at the |CONSLD | None ' 
jrelevant slot in the dictionary block control | | { 
jarea (DSLOTS) | | | 
1 | | 
| Parameters passed: PAR1 -- dictionary | | 
| reference | | | 
| Parameters returned: Address of slot in GRA | | | 
| Entry to the operating system: None { | | 
Ne aaa aa 
[Takes a text reference and points at the | CONSLT | | 
jxrelevant slot in the text block control area | | | 
| (TSLOTS) | | | 
| | | | 
| Parameters passed: PARI -- text reference | | | 
| Parameters returned: Address of slot in GRA | | | 
| Entry to the operating system: None | | | 
mann nn nn nnn nnn nnn }~--—------------—--------------—----—--} 
jAllocates space for a text block | TRYMRT |DFREE, TFREE, ZUPL, | 
| | | ABORT | 
| Parameters passed: Relative track address of | | | 
| the block (if block is on disk) in RDTTR. | | | 
| Otherwise RDTTR is zero | | | 
| Parameters returned: Address of block in GRO | |. | 
| Entry to the operating system: GETMAIN(VC) if | | | 
| storage available. OPEN if no space left { { | 
| for text blocks | | | 
Soa a eS 
|Allocates space for a dictionary block | TRYMRD |DFREE, TFREE, ZUPL, | 
| | | ABORT | 
| Parameters passed: Relative track address of | | 
| block (if block is on disk) in RDTTR. oOther- | | 
{ wise RDTTR is zero | | 
| Parameters returned: Address of block in GRO | | 
| Entry to the operating system: GETMAIN(VC) if | | 
| storage available. Open if no space left for | | 
| dictionary blocks | | 
a ne ee rr ee re a ee ee rn en bee pe ee ew en a een nnn en nn nn eee | 


{Investigates the dictionary block control used | DFREE 
| (DSLOTS), to find which block can be written on| 
jto disk to make space for a different block in | 
|storage 


CONSLD, ZUERR, ABORT, 
WDREAD, WRTRD, WDWRIT 


| 
| Parameters passed: Relative track address of 
| block required in storage in RDTTR. RDTTR=0 
| if a block is being created 

| Parameters returned: Address of block in 

{| storace in BLOKAD 


Entry to the operating system: None 


ee gt 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
4 
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Table AL/AN. Modules AL/AN Extended sate win A compa Phases (cont'd) 


| - ]Main Processing] Routine Called 1 
| Statement or Operation Type | Routine | | 
p----—--------- -- ----—- ---- -- -- -- + +--+ ef ee et 
jInvestigates the text block control area | TFREE |CONSLD, ZUERR, ABORT, 

| (TSLOTS), to find which block can be written |WDREAD, WRTRD, WOWRIT 
jonto disk to make space for a different block 
jin storage 


block required in storage in RDTTR. RDTTR=0 
if a block is being created 


| 
| 
| 
Parameters passed: Rélative track address | 
| 
Parameters returned: TFREE | 

| 


Entry to the operating system: None 


+ — 


a ee a cc ae ee ee a ce ee ee er ce ee a ee ee ce we eo ee a hee ge re ee ee em worn en - -- - - --- - | 


| 
| 
| 
| 
| 
|Create space in storage by writing on disk | WOWRIT | WRITEX 
| | | 
| Parameters passed: RDTTR=0, BLOKAD contains | | 
{| address otf block that can be written out | | 
| Parameters returned: BLOKAD contains address_ | | 
| of block in storage that is now available | | 
| Entry to the operating system: WRITE(BSAM), | | 
| CHECK, NONE | | 
}--------------~---~—-~------------------------ }---------—---- }-~~-------------------- 
{Writes a block onto disk and reads a second one|WRTRD |READX, WRITEX, ZUERR, | 
jinto its place in storage | ABORT | 
| | | 
Parameters passed: RDTTR contains relative | | | 
| track address of pnlock to be read. BLOKAD | | | 
| contains address of block to be written | | | 
| Parameters returned: NOTTR contains relative | | | 
| track address of block in storage | | | 
| Entry to the operating system: WRITE(BSAM), | | | 
| CHECK, NOTE | | | 
| ---~-—--- ~~~ = nn = + - fo n= fof 
|Reads a block from disk into space already | WOREAD | READX | 
Javailable in storage | | 
| | 
Parameters passed: RDTTR holds relative track | | | 
| address of block to be read. BLOKAD holds | | | 
] address cf space in storage | | | 
| Parameters returned: BLOKAD holds address of | | | 
| block in storace | . | | 
| Entry to the operating system: None | : ! 
i ce nl er Se ste > Sto ee em woes a ea cc $---—----~+~--~+---—}-----+-~--------- +--+ 
|Writes a block onto disk | WRITEX ae ZEND ! 
| « 
| Parameters passed: TEMP4 holds relative track | | | 
| address of space on disk | | | 
| Entry to the operating system: XDAD(WI), WAIT | | : 
i es eS rr 
|Reads a block from disk | READX one ZEND 
! Parameters passed: TEMP4 holds relative track | | | 
| address of block on disk | | | 
| Parameters returned: PAR1 -- address of input | | | 
| area | | | 
| Parameters returned: PAR2 -- record length | | | 
| Entry to the operat operating system: GET MOVE ay ! | 
|Reads a record from SYSIN hook ia : 
Parameters passed: PAR1 -- address of input | | | 
| area | | | 
| Parameters returned: PAR2 -- record length | | 
| Entry to the operating system: GFT MOVE nee I | 
Bs ieee ee ea ee a a ee ee 
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Table AL/AN. Modules AL/AN Extended Dictionary/Dictionary Phases (cont'd) 
Sr rr an ee eee a ee ee ee ee a ee ee 


| |Main Processing| Routine Called 
| Statement or Operation Type | Routine | 


{Puts a record out to SYSPRINT. Pagination 
| (paging action) is performed automatically 


| Parameter: passed: PAR1 -- address of output 
| buffer. PAR3 -- address of output buffer 

| containing page headina (if any) 

| Entry to the operating system: PUT LOCATE 

| (QSAN) 

t 


[Finds a new text block. Optionally chains the 
jnew block to the current block and changes the 
Jstatus of the current block 


CONSLT, TRYMRT, ZUERR, 
ABORT, BLKERR 


Parameters passed: PARI -- optionally, a 
reference to the current block. PAR2 -- a 
status and chain indicator 

Parameters returned: PAR1 -- reference to new 
block: PAR2 -- absolute address of the 
beginning of block 

Entry to the operating system: None 


|Finds the next text block in the chain. | ZCHAIN |CONSLT, TRYMRT, BLKERR 
{Optionally, changes the status of the current 
| block 


pe ee ee ee re ee ee ee oe 


| 
| 
Parameters passed: PAR1 -- a reference to the | 
current block; PAR2 -- a status indicator | 
Parameters returned: PAR1 -~- reference of the | 
next block in the chain. PAR2 -- absolute | 
address of next block in chain | 

| 


Entry to the operating system: None 


. 


aye cme eee eee ce a oe 


|Changes the status of the referenced text block|ZALTER |CONSLT, BLKERR 


|. 

| Parameters passed: PAR1 -- a reference to the 
| block. PAR2 + 3 -- required 'status' byte 

| Entry to the operating system: None 


| 
| 
| 
4 
{Converts a text reference to an absolute | ZTXTAB 
| 
| 
| 
| 
| 
| 
| 


CONSLT, TRYMRT, BLKERR 
jaddress and optionally, does not change status 
Jof the block 


Parameters passed: PAR1 -- reference to be 
‘converted and option indicator bit 
Parameters returned: PARI -- the absolute 
address 


oe ee ce cee Se cee eee OD orf creme rs a ome 


| 

| 

| 

| 

| 

| 

| 
Entry to the operating system: None | | 
ies a SCE AS cms SSI wa CIS LMS NR of IT gE GOP SLES PRICE CTC CR 
jConverts an absolute address to a text | ZTXTRF |CONSLT, BLKERR, ZUERR, | 
| reference | | ABORT . | 
| 

| 

| 

| 

| 

| 

| 


| 
Parameters passed: PAR1 -- a text reference to| 
the block containing the absolute address; | 
| 


PAR2 -- the address to be converted 

Parameters returned: PARI -- the required text| 

reference | 

Entry to the operating system: None | 
fn a nn nn fen nnn enn ean nanan mmner| 
|Bnters messace "REFERENCED BLOCK NOT IN USE‘ | BLKERR | ZUERR, ABORT | 


Jinto dictionary and then terminates compilation| | | 
| Entry to the operating system: None | | | 
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Table AL/AN. Modules AL/AN Extended Dictionary/Dictionary Phases (cont'd) 


C(O LP LS LS ES LA LS ES SS A SNS SS ED SN SN Se NS RD WD DoD —— ee oe oe oe om oe ee ow ewe ee ee ae ae oe re a we ee ee ee ee eee 


e e ~T 2 1 
| | Main Processing| Routine Calles | 
| _ Statement or Operation Type © | Routine | | 


_ e+--------—---—- -- -- —- - +--+ ee ek 
|Supplies storage space for scratch purposes. | ZUGC laiae. ZUERR, ABORT 
{Allocation is made in 512 bytes at a time | 
| Parameters passed: PAR1 -- a count of the | 
| ‘number of 512 byte blocks required | 
| Parameters returned: PAR1 -- address of the | 
| allocated storage | 
1 


Entry to the operating system: None. | 


(soe el 


| 

| 

| 

| 

| 

| 

t 
{Converts an absolute address to a Gacesonary | ZDABRF “| CONSLD, ZUERR, ABORT, | 
|xeference | BLKERR | 
| Parameters _ passed: PAR1 -- any reference to | 
the block containing the absolute address; | 
PAR2 -- the absolute address to be converted | 
Parameters returned: PAR1 -- the required | 
dictionary reference | 
| 

4 


Entry to the operating system: None 


pe cee ee eee ae aoe 
ee ee ee aD aD we 


efferent: cess emma Aa A mers eo 


|Converts a dictionary reference to an absolute | ZDRFAB | CONSLD, TRYMRD, BLKERR 
|address | 
| Parameters passed: PAR1 =esthe dictionary | 
| reference tee | 
| Parameters returned: PAR1 -- the absolute | 
| address ee | 
| Entry to the operating system: None |. 
pana ann nnn nn nnn nnn nf nf = 
{Makes an unaligned dictionary entry and | | ZNALAB | ZDRFAB, ZDABRF, TRYMRD, 
jreturns an absolute agares® | | ZUPL, ZUERR, ABORT, 

| CONSLD 


| 

| 

l | | 
| Parameters passed: PARI = address of entry to| | | 
| be made; PAR2 -- length of entry | | | 
| Parameters returned: PAR1 -- address of entry | { | 
| in dictionary. PAR4 -- some reference to the | | | 
| block | | { 
{ | | 
4 


Entry to the operating system: None . | 


{Makes an aligned dictionary entry and returns |ZDICAB _|ZDRFAB, ZDABRF, TRYMRD, 
Jan absolute address | | ZUPL, ZUERR, ABORT, 
| | | CONSLD 
Parameters passed: PAR1 -- address of entry to 
be made; PAR2 = Tengen of entry 
in qicciones bane -- some reference to the 
block 


Entry to the operating system: None 


| 
| 
| 
| 
| 
| 
[aa Ss Snap amC ARaease an (RASISERIR NTE AIP AGE Aa RRNS Ie —--4 
|Makes an unaligned dictionary entry and | ZNALRF |ZDRFAB, ZDABRF, TRYMRD, 
jreturns dictionary reference | |ZUPL, ZUERR, ABORT, 
| | CONSLD 
Parameters passed: PAR1 -- address of entry to| 
be made; PAR2 -- length of entry { 
Parameters returned: PAR1 -- reference of | 
entry in dictionary. PAR4 -- absolute address| 


of the entry — | 
Entry to the operating system: None | 


| 
| 
[ 
| 
| 
| 
| 
| 
| 
ba ee ee ee ee eae ane | 
| 
| 
| 
| 
| 
| 
| 
| 
4 


{Makes an aligned dictionary entry and returns a|ZDICRF | ZDRFAB, ZDABRF, TRYMRD, 
jdictionary reference | |ZUPL, ZUERR, ABORT, 

| | | CONSLD 

| Parameters passed: PAR1 -- address of entry to| 
| be made; PAR2 -- length of entry 

| Parameters returned: PAR1 -- reference of 

| entry in dictionary. PAR4 -- absolute address| 
| of the entry \ 
t 


Entry to the operating system: None | 
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Table AL1/AN1. Modules AL/AN Routine/Subroutine Directory 





| Routine/Subroutine| Function 

~----—--—-------- | ----—--------------------------—--—---—---------—- ~---------—------ i 

| TFREE {Finds text block which can be written on disk 

t {to make space for a new block in storage. 

\ 

{| TRYMRD |Allocates space for a dictionary block. 

| | 

| TRYMRT {|Allocates space for a text block. 

| | 

| WDREAD |Reads a block from disk into storage. 

| | 

|WDWRIT {Creates space in storage by writing a block on 

| | disk. 

| | 

| WRITEX |Writes a block on disk. 

| | 

| WRTONL |Writes on last block on disk. 

{ 

|WRTRD |Writes a block onto disk, reads a second one 

| jinto its place in storage. 

{ | 

| ZALTER {Changes status of referenced text block. 

| 

| ZCHAIN |Finds next text block in chain. 

| | 

| ZDABRF |Converts an absolute address to a dictionary 
| reference. 

ZDRFAB {Converts a dictionary reference to an absolute 
|address. 

ZDICAB {Makes an aligned dictionary entry and returns 


a8 9 os 8 68 
pa2 E EG 3 


aR & 


e 


| a | a oe ee oe eo 2s oe 0 oe rs 9 ee > 8 on a ee te ee 0 a ke ee On a 8) ee we ew ee eee 


jabsolute address. 


|Makes an aligned dictionary entry and returns 
|dictionary reference. 


|Makes unaligned dictionary entry and returns 
{dictionary reference. 


| 
[Makes unaligned dictionary entry and returns 
jabsolute address. 


eens text reference to an absolute address. 
{Converts absolute address to a text reference. 
{Inserts diagnostic message in dictionary. 
[Rens a record from SYSIN. 


|Supplies storage space for scratch purposes. 
| 

{Releases scratch storage. 

| 

{Puts record out to SYSPRINT data set. 


| 
{Obtains a new text block. 
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Table AM. Module AM Compiler Control Phase Marking 





eS SS ee ee ee fee ee a 
| Main Processing| 1 
| Function | Routine | Routines Used | 
{Marks all non-optional phases and |IEMAM |REQEST, RLSCTL (both in AA) 
{all phases influenced by compiler | | | 
‘|invocation-time options | | | 
heen eee ea eases a te aaa ia et 6 Ee en ea tS r) 


eTable AT. Module AT Compiler Debugging Module 


CS ee aay {esses neneon=T Ep RS ERD ee ED GED ERD OS A A ae aD OD EE ee a oe a ce > > ED CES GED ES ah ED a ae ge 7 


|Main Processing| | 





| Statement or Operation Type { Routine | Routines Used | 
SS Sere re ee ee ee ee a ee Se 4 
{Reads in control cards and {INIT | CNTRL, NXTFLD,TROFFSET, ZUPL(AA) , | 
{constructs control tables | | ZURD (AA) | 
{Entry to the operating system: None| | | 
a a nn a nnn an fan nnn nnn f nn nnn nn nnn nnn rn nnn | 
{Entered each time a phase is loaded|LOAD | PATCLOAD, TRACLOAD , ATCALL, HEXOUT, | 
|so that replacing (REP) or | | JBPT 


|verifying may be done. Inserts { 
|start or end trace/flow markers | 
| (privileged operations) | 

| 


|Entry to the operating system: None 
t + 


{Entered each time a phase is | TRACRELS 
|deleted and updates control tables | 


{Entry to the operating system: None| | | 





aa nn nna nf nnn nnn nn nnn nnn nn nnn 
{Entered from Interrupt Handler in |TRACEIT | ATCALL, JBPT 
|module AA after privileged . | 
|operation encountered (0C2 | 
jinterrupt) signifying trace/flow | 
jmarker. Carries out initialization| 
| before starting or after ending | 
| trace/flow | 


{Entry to the operating system: None| 





ape ee ee ee ee ee ce ee 


|Analyzes each instruction to be | TRACE | CALL, FULLSUB, POLL2, JBPT, FULLAD 
{traced. Executes the instruction | 
jand prints a line containing: the | 
jinstruction, its address, the | 
|resulting condition code, and the | 
|subsequent contents of registers | 
jand storage used by the | 
I 
{ 
| 


ee coe come eee aaeee que eee axe exes ame lee oe eee a ee ee a ee coe 


{instruction. 
{Entry to the operating system: PUT 
|MODE (QSAM) 


ences cee a ete ae eee we ecw ee a ee ae oe ene ae eee re a eee ew ne Myce ee en eae ooo a ae a SS Sapa ee ee a a OD | 
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eTable AT1. Module AT Routine/Subroutine Directory 
Se ee ee Ee ae ee ee eee ee ee ee | 
| 


| Routine/Subroutine Function | 
SP AE or ene EES GED Te EE ee SD eens GOERS em Ee vie TS PE ES A AS AS ES Ae A ie A a A A a Ae A a a a A a ee a a a a EE a a ee ee ae ee a eS ee a Pe eee oe eee ae ee eee eee 4 

| ATCALL {Calls the print routine and then clears the print line. | 
| | 

| CALL {Similar function to ATCALL but contained within TRACE routine. | 
| | 

| CNTRL {Carries out replacing (REP) and verifying in phases loaded before | 
| {AT. Inserts start trace markers in phases loaded before AT. | 
| | | 
| FULLAD |Determines address of storage to be altered by instruction currently | 
| [being traced. | 
| | | 
| FULLSUB {Translates hexadecimal to a character representation of hexadecimal. | 
| {Used in TRACE routine. | 
| | | 
| FULL2 |Analyzes instructions to be traced and moves information to the | 
| [print line. | 
| | | 
| HEXOUT {Similar function to FULLSUB. Used in routine LOAD. | 
| | 
{INIT |Builds control fields using information from control cards in the | 
| j input. | 
| Ue ; . ; \ 
|JBPT {Prints a line of trace information. | 
| { ; | 
| LOAD |Controls subroutines PATCLOAD and TRACLOAD. | 
| | 
| NXTFLD |Skips blank characters on input control cards. | 
i | | 
| PATCLOAD {Carries out replacing (REP), if requested, after each phase is | 
| | loaded. | 
| { | 
| TRACE |Traces each instruction and prints trace information. | 
| | 

| TRACEIT |Describes whether TRACE/FLOW must start or end. | 
| | 

| TRACLOAD |Inserts start trace markers in phases after they have been loaded. | 
| | | 
| TRACRELS |Updates control tables when a phase is deleted. | 
\ | 

| TROFFSET |Translates character representation of hexadecimal to hexadecimal. | 


De ee ee ee a hn nn nn en ne en oe I) 
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Chart BM. Phase BM Overall Logic Diagram 
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Chart BW. 
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Table AS. Phase AS Resident Phase for Compile-time Processing 


a ere ee poe ee ee ae SE a aa a a ac a 7 

|Main Processing] 
| Statement or Operation Type | Routine | Subroutines Used | 
pen 2 nnn = nf nnn nnn nnn nnn nn nnn nn nnn nnn nnn nna 
{Initializes switches for | ADRP | None | 
|compile~time processor | | | 
~------------—----~--------------- }--------------- }-----------------~-----------------4 
{Loads phases for compile-time | ADRP {LOADX (AA) | 
{processor | | | 
}---------—--------—------------— {--------------- $----------------------------------- 1 
jDetermines whether Phase BC should |ADRP | None | 
[be reloaded | | | 
Di a a a a i ae rae ee a On at ea eee a lel ee ee ee J 
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Table AS1. 
(7-——-------—-- 
| 


Routine/Subrout ine Function 
nr ce cap ae ram nie rene os ear ie eres ial mia laa een ie eaten 
| ADRP [Initializes switches for compile-time processor. 

| 

| BCKUP2 {Backs up token pointer two places. 

| 

|CHBLK {Changes currently busy IVB block status and gets a new block 

| 

| CLSBUF |Handles calls to close and write out the buffer. Loads and bases 
| jphase BJ if necessary. 

| | 

| COMENT |Scans the limits of a comment, transfers each character into the 

| Joutput buffer. 

| 

| ENDIVB |Closes an IVB chain. 

| | 

| FREVAL |Releases a chain of IVBs containing a no longer needed value and 

| jreturns chain to free list. 

| | 

| GETIVB |Removes an IVB from the free chain for use by the calling routine. 
{ 

| GNC | Updates TOKPTR to point to the next character in a particular input 
| |stream. 

| 

| HASH |Accepts an EBCDIC identifier as input and outputs an index. The 

| jindex indicates the beginning of the HASH chain with which the 

| {identifier is associated. 

| \ 

{INcTST {Determines whether Phase BC needs to be reloaded on return from 

| |Phase BG. 

| ee 

| INPUT {Reads in an input record from the source data set or from included 
| text. 

| I 

| INRD |Reads physical records from the included data set; unblocks and 

| {sends them back one logical record at a time. 

{ | 

| NXTTXT {Gets a new text block and sets up address slots. 

| 

| OUTPTC jOutputs a single character into one of the three output media: 

| {IVB's, text blocks, or external records. 

| 

| SRHDIC |Searches the dictionary for the presence of a named item. 

| | 

| STRING |Scans the limits of a string constant, transfers each character to 
| joutput. 

| 

| TOKSCN [Examines text, character by character recognizing and returning each 
| Jlogical unit of text (called a token). Tokens include identifiers, 
| |constants, operators, delimiters, etc. 

| | 

| UPNEWL {Updates temporary linecount slot. 

| | 

| YAG2 |Loads processor phases for the compile-time processor. 

bes oe ee es 9 a pam St pas PR Se aI NE El ra a TU Ya fr te nen ee RICE Te 


Phase AS Routine/subroutine Directory 
otmcen ety mom ae we ema aan aie eee ee eee woe aa ee eas SS 
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Table AV. Phase AV Macro Processing Initialization 


Ce a ee egg ae or ee Tete ee EA eR a a aca aaa ae 1 
{Main Processing] | 

| Statement or Operation Type | Routine | Subroutines Used | 
}---------------~-------------------}---------------}-----—----~-----------------------] 
|Initializes communication area for |INIT | None | 
jcompile-time processing | | | 
}---------—------~------—-------—--- }~-------—------ }~---~--~--------------------------- { 
|Allocates push down stack from | INIT | None | 
|scratch storage | | | 
}--—------------------------------- }--------------- 4$----------------------------------- : 
{Allocates translation tables | INIT | None | 
wa nn na nanan n= nn ap nnn nn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nna 
{Enters SUBSTR into dictionary | INIT | None | 
cae a ee ie ee a eee ae 4 
{Creates dictionary entries and {INIT | None | 
|values for constants pool | | | 
Dag as sce a te iat ana aa hoe Seema a ae ee aS J 


Table AV1. Phase AV Routine/Subroutine Directory 
Se ae ee ee ee eee ed 
| Routine/Subroutine | Function | 
pa na nn nnn nn nn nnn nnn nr ceed 
[INIT | {Entry point to the initialization phase. This initializes the 
|communication region for compile-time processing. 


WWAO04S |Allocates the push down stack (to be used by Phases BC and BG) from 
|scratch storage. 


| 

| 

| 

| 

| WWOVLP |Sets up tables to translate external code to EBCDIC; tests the 
| { BCD, EBCDIC option. 

| 

| WWOBCD JEnters built-in function SUBSTR into dictionary. 

| 

| WWCHNBEG |Creates dictionary entries and values for compile-time constant 
| | pool. 

| 

| WWMOVEIT |Moves Subroutine package into core for use by BC. 

| 

| INCLUDE | INCLUDE Processor 

| | 

[LABELS (BC [LABEL List Processor. 


| GOTO Subroutine |GOTO Statement Processor. 
jACT Package) |Active/Deactivate Processor. 


| | 
| ELSE |ELSE Clause Processor. 


bone es eee eee eee ene ED eS EE Se CE ED NE A SS SS SD a UE cS 


| 
| 
| 
| 
L 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
: 
: 
| 
| 
| 
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Table BC. Phase BC Initial Scan and Translation 


ip ae eee ra a ee ee ee SA. aa a a aor a a 1 
| {Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used { 
po =e nnn ne nn nnn nn nn nnn nnn 
{Recognizes statement type | PH1ISCN | TOKEN, DELETE | 
a Na sl aE arg te iS A a a a a 4 
{Scans until next % character | PH1SCN | FINDPC | 
|------------—----------—----------}--------------- }-----—---------------------------- 4 
{Processes PROCEDURE statement | PHISCN | TOKEN, DELETE, IDSRCH, | 
| | J ADDSP (FREVAL, OUTPTC) | 
| --—------ ~~~ --- == == frown nnn nnn nn nnn nnn nnn ee enna nnn { 
{Processes labels attached to | PH1SCN | IDSRCH | 
| statement | | | 
~------------------—-----—-------- $--------------- }---------------------------------- 4 
{Encodes statement into internal | PHLSCN |PARSE, TOKEN, IDSRCH, ADDSP | 
jtext | | DELETE, CHECK | 
own nnn nnn fn nnn nf nnn nn nnn nnn nn meen mene { 
jCleans up after INCLUDE in initial |PH1SCN | None | 
|scan | | | 
fers ee ee dae oes ee a ter eT 1 
{Begins statement identification | PH1SCN | None | 
| process en | | | 
1 
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Table BCl. 


Phase BC) Routine/Suproutine Directory 


ney ois ee ore pe a ee ene De ag a ap reg a ee ey ty pee OO a Po ee EN be fe Rage Mar gee Spans Op ET g Ogee et ene Te ee 1 


[Routine/Subroutine| 


Renee ce ee eA PTET TTETETTEETEEETETEET EEE EEE 


| ADCONS 
| 


| 
| ADDSP 


| 
| ADICT 
| 


| 
JADPRCC (BF) 


| 
JASSIGN 


1 
| CHECK 
( 


| 
JDECLAR (BF) 


| 
| DELETE 
| 


| 
[pO (BE) 


{ 
{DONE (RE) 


FINGPC 


Function 


{Obtains the dictionary reference of a constant, entering it into the| 


[dictionary if necessary. 
|Adds a processor-created item to the dictionary. 


{Adds a normal itein to the end of the appropriate hash chain and 
|returns the dictionary reference. 


{Processes PROCEDURE statement. 


|Processes assignment statements. 


{Checks back for undefined labels and identifiers not declared within 


jthe block. 
| 


_|Declare statement processor. 


| 

|Skips over bad text up to the end of a statement, field or 
{ procedure. 

| 


}O0 statement processor. 


|Checks stack tor possible THEW's or ELSE's after statement is 
|completed. 

i 

{Scans source text, character by character, searching for macro 
Jeercent character. 

| 

jObtains the dictionary reference of an identifier, entering it in 
jthe dictionary if necessary. 

| 


{IF statement processor. 


jChecks for single or multiple keywords. 


| , 
|Parses and generates interpretive macro code for compile-time 
Jexpressions. 


|Provides special handling for end of included text. 


{Main controlling routine for phase. 


RETURN jProcesses RETURN statement for PROC. 

STB3 {Collects labels into label list and identifier statement type < on 
|first two tokens of statement. 

STMT (BE) {Diagnoses statement type and builds label list. 
| : ; 

TOKEN jReturns significant tokens to PH1SCN and writes out diagnostics for 
jtokens in error. 

UPOLIN | |Generates an update linecount instruction. . | 

tet esS eee a= Lo ne + 
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Note: See also BC Subroutine Package in Table AV1. 


Tabie BG. 


Phase BG Final Scan and 


Replacement 


Bee i ae ns a ee Me ee Dy Ce ee ee ogee ee ge ee 1 
|Main Processing] 


| Statement or Operation Type | Routine | Subroutines Used | 

ao 2-2 === }--------------- }~=-----~.-------------~------------- { 
JEinal sean for replacements | PH2SCN JOUTPUT, TOKSCN, SRHDIC | 
fa nn nr nn fn nen enna nnn nnn nnn nnn anna : 
[Recognition of end of text | PH2SCN | OUTPUT, TOKSCN, SRHDIC | 

~----~----------------------------- }---------------}-----------------------------------] 
|Recognition of an identifier | PH2SCN (OUTPUT, TOKSCN, SRHDIC | 
panna nnn nnn nnn enn nnn fo nwnn nnn nnn nnn fon nn nnn nnn nnn nn nena enn : 
|Recogniticn cf macro action | PH2SCN JOUTPUT, TOKSCN, SRHDIC | 

=--~~------~------~----~----------- fon man ann nnn nnn enn nn nnn nn nnn nnn nnn n= =f 
{Recognition of % character | PIE2SCN } OUTPUT, TOKSCN, SRHDIC | 

wa nnn nnn nnn nnn fanaa nnn np nnn nnn nnn nnn nen ==--- == === === 
{Recognition of other characters | PH2SCN | OUTPUT, TOKSCN, SRHDIC | 
pe ete eee ae ea eee 4 
{Terminates and cleans up INCLUDE | PH2SCN | OUTPUT, TOKSCN, SRHDIC | 
jhandling | i | 

wo f---- 4------~- -- -- --- - - + - -- - - + - - --- + - 4 
|Re-establishes scan at next higher |PH2SCN {OUTPUT, TOKSCN, SRHDIC | 
jlevel text | | | 

a aaa coe aca ie ac ae cat tac Sonia taal f------------+~-}--------------- +--+ +--+ ------------| 
{Performs replacement on activated |PER2SCN [| OUTPUT, TOKSCN, SRHDIC | 
jadentifiers | { | 
Mc as rk a a hah ale alate rin aa ae eg Soe es eR eer er a J 
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Table BGi. 


Phase BG Routine/subroutine Directory 


ee ec at eg eC a a ee a ma ae Som a oe ere Sr min ma 


| koutine/Subroutine | Function | 
[CLOUT (BJ) [Closes output buffer, and writes out record on SYSUT3. SOS 
recaiee |Handles conversions between the three data types used in the ! 
| {compile-time processor . | 
‘saci ietaaeecee INCLUDE text handling and frees text blocks containing | 
| Jincluded text. | 
loeeos Receaaniisnes scan at next higher level text. 
iaaeORS peesoan ives and processes end of text condition. 
ioeipen te eeeea yee and processes identifier in text. 
DANAE i acebaniede and processes macro action character. 
|DAGTHR a menoowines character and outputs it. | 
aes jHandles replacement operation for text identifiers. 
‘ Seete |Recognizes % character and recalls Phase BC if appropriate. | 
beguerWiess jHandles built-in functions. 
ae | Picks up a two-byte dictionary reference from scrubbed text, ! 
{ |performs error checking, resolves indirect references, and returns | 
| {both relative and absolute address. | 
econ: acaOuE control routine. Opens DCB, finds member, sets up buffer, 
| Jand initiates look-ahead read. | 
riper (Bi) jInterprets the macro code generated by the Phase I scan. ! 
‘eaves hanes the output of tokens. 
‘ cabacn tavene text blocks. ! 
teGs eee the top temporary off the Phase II stack. ! 
Seouny (BI) {Special entry point to interpreter for invocation of procedures 
| |found in source program text. | 
fades | Pushes next available temporary onto the Phase II stack. ! 
{PUNCH (BJ) ee down output record, in source code, on MACDCK option. ! 
Pen |Synchronizes linecount, closing buffer if necessary. ! 
— |Scans for procedure reference argument list left-parenthesis. ! 
ienmeeen (BI) |Performs identifier assignments for INTPRT. 
lekeour (BL) |Performs all logical comparison operations for INTRPT. | 
s eaeoueas (BI) {Performs string concatenations tor INTPRT. | 
ee (BI) laaieees stack items to required type by ‘RETURNS" attribute. 
NgRUGeE (BI) eepaeas all logical operations for INTPRT. 
Naas (BI) Leama stack maintenance for INTPRT. 
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Table BGi. Phase BG Routine/subroutine Directory (cont'd) 


(Sr srr TST ee ee cee ee ee ee ee ee ae ee ee ce ee ee ee ee ee ee en se re ee ee ee ee re ew we ew ee we we we ee re ee we we en ee ee 


| Routine/Subroutine| Function 

[ZARITH (BI) [Performs all arithmetic operations for INTPRT. 
ere (BI) ene transfers from included text to including text. 

eeene (BI) {Performs all transfer operations for INTPRT. 

|235uEs (BJ) ieustt 22 function SUBSTR. 
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Table BM. Phase 8M Diagnostic Message Determination ani Printing 


eo oe ae ee ge |Main Processingy) = 1 
| Statement or Operation Type | Routine | Subroutines Used | 
poe ee ae ee i 
Jaxre to be printed | | 
[Scans error message text skeletons {KAS {zaso, xa70, a90, XA410, Zep 
jan3 prints them out. | | | 
eee ene hla a i a a le ga eo Bp i a ili See So ee 4 
Table BM1. Phase BM Routine/Subroutine Directory 

[Routine/Subroutinel| st—i“‘<‘éOS;#*;éRURCHiNO||=©=©=©0©0)0™™™~—OCS 
a Determines whether error messages are to be printed. SS 
| XAO oe severity code. ! 
| XAO1 |Establishes which message types to suppress. 
| XA1 conus number of error chains to be processed. 
| XA2 ae out messages if there are no diagnostics. ! 
| XA4 Prints out “COMPILER DIAGNOSTIC MESSAGES". 
ae oor scan of message chains. 
| XA8 |Scans error message text skeletons and prints them. 
| XA9S (BN) poe to head of next non-empty chain. 
| XA12A iebieces and prints header for messages of given severity. 
fase (BN) eees next. entry in message chain. | 
| XA32 (BN) rauiwes up first part of message in buffer. | 
|XA35 (BN) Vanteewes message skeleton. 
|XA40 (BN) ies out completed message. 
{XA50 (BN) seus message text to print buffer. 
{XA70 (BN) ee binary statement number to character representation, and 
| |moves it to print buffer. | 
rer (BN) eeanes binary numeric value to character representation and moves : 
| jit to print buffer. | 
ena (BN) |Moves identifier from dictionary entry to the print area. 
| UPL . | [prints a line on SYSPRINT data set. 
Lo -— n - 
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Table BW. Phase BW Clean-up Phase 


; 


—— 
i 
{ 
! 
{ 
I 
! 
{ 
{ 
| 
| 
{ 
{ 
I 
t 
! 
{ 
! 
| 
1 
{ 
I 
{ 
I 
! 
I 
) 
1 
! 
{ 
t 
' 
I 
{ 


Main Processing| 
| Statement or Operation Type 


Hi 
| Routine | Subroutines Used 
an nn a rt rr rr rr 4 a fr rn + -- - | 
{Resets all tables and | TEMBW | None 
jcommunications region cells to the | | 
|value required by the compiler | | 
|proper | | 
Rae a pi a ee 5 ee nee ae eee Be ae Be he J 
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Chart 02. Read-In Logical Phase Flowchart 
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Chart BX. 
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Phase BX Overall Logic Diagram 
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Chart CO. Phase CO Overall Logic Diagram 
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Chart 


CS. Phase CS Overall Logic Diagram 
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cv. 


Phase CV Overall Logic Diagram 
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Table BX. Phase BX 48-Character Set Preprocessor 

ee a a a a re Sa 
|Main Processing| | 

| Statement or Operation Type | Routine | Subroutines Used | 


wa nnn na a nnn nn nnn nnn nnn nnn nn nnn nnn nnn 
|Translates keyword table to | BAOO | None | 
Jinternal code and initializes | . | | 
}--—----- -——-------—---—------- {----------—--- fren nnn mene nnn { 
|Reads a record | BA1 |ZURD (AA) | 

man nn nn an nn nn nnn af nn nnn nnn nn nnn nnn nnn nnn nf 


{Scans text | BALA | None | 


amma nn nn nn nnn nf nnn nnn nnn nn en nnn 


{Handles operators and keywords | BAS | None | 


|Replaces operator keywords | BA11 | None | 
}-------------—-----—---—-----------}--—----------} ---------- —-------------------- 4 
|Replaces comma-dot by semi-colon | BA20 | None | 
jwhere applicable | | | 
ma nn nn nn nnn nn nn nnn nn nnn nf nnn nnn nn nnn nnn nn nnn 
|Deals with quote marks | BA25 | None | 
|-------------------—-------------—} --------—------} ----------—----------- +--+ -----4 
|Maintains parenthesis level count {|BA30 | None | 
| ----------------------- ---------- —} ---------------} ---------- = - === === 
|Replaces period-period by colon | BAGO | None | 
|-----—-------------—-----—-- -- —--} ---------------} -----—-- ------------------------—-4 
{Processes a slash |BA50 | None | 
ma nan nnn nn nn nnn nn nnn nnn nnn nnn nnn 
{Reads one record ahead in case of |BA70 | None | 
|need | | | 
Seas ey a ee ered 
{Restores the situation when a read |BA80 | None | 
{ahead has taken place | | | 
jPuts out converted text and | BA90 | ZUBW | 
joriginal text onto backing store | | | 


tae Oe re te ee ee eS ee a ED A ED ES SED OO ED Oe ERED GEA ee a ism Mc ccm cs cis ns Sra ia tel we cas emae A Ee RD OD ED en OU GD END CED OEE ke EE ED EE DD le SE a ee ee oe J 
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Table CA. Module CA Read-In Common Block 1 


eee ee Oe ee Se ee ee a ee 
| Function { Subroutines | 
pra nnn nn nn nnn nnn nnn nn nnn fn = 2 === - 
| Provides subroutines common to all five |ACONST, DECINT, EXP, EXPAND, EXPLST, IDENT, | 
|passes of the read-in phase TAVCHAR, OPTOR, SCONST, SINGLE, SQUID | 


Table CA1. Module CA Routine/Subroutine Directory 


[Routine/Subroutine}| = = Function ‘| 
‘Nout «Clade fora Galle ariiatioca. 
| DECINT “checks decimal integer. ! 
os ateenones expressions. ! 
| EXPAND |Expands iterations of string constants and picture characters. ; 
|EXPLST {Checks for a list of expressions separated by commas but enclosed ini 
| | parentheses. | 
| IDENT ioieeie for a valid identifier. | 
| MVCHAR fee text from one address to another. 
| OPTOR {Checks for an operator and replaces the two-byte operators by 
{ : jone-byte codes. | 
| SCONST eieeies for a valid string constant. ! 
| SINGLE inieeieece a single expression in parentheses. 
| souID [checks for a valid subscripted and qualified identifier. 
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Table CC. Module CC Read-In Common Block 2 


pe re ee ee eee eee eS ee ee ee ee ee ay 
| Function | Subroutines | 
ne a rn rn rn rs nn fr nn re 
|Provides subroutines common to all five |CHAR, CHECK, KEYWD, MESSAGE, NONEX, | 
|passes of the read-in phase |NULINS, OPTEST, PICT, PREC, SOFLOW | 


ER Ee 


Table CC1. Module CC Routine/Subroutine Directory 


 acticiasiecha lenient helmet see spats aa a a a a aaa aati rene a ns | 
| Routine/Subroutine | Function | 
ERNE nC ACRES pe Rene RNR ae Eon Tae PRES PPE NT ER rt ES RI nk I Ee Te eT ON RI TT aT 4 
| CHAR |Diagnoses the CHARACTER and BIT data attributes. | 
| | 
| CHECK {Tests the top entry in the stack. | 
| 
| KEYWD [Identifies keywords and hands back the replacement character to the | 
| caller. | 
| | 
| MESAGE | Provides a diagnostic message. | 
| 
| NONEX |Checks stack for non-executable statements. | 
d | 
| NULINS }Inserts null statement in output text. | 
| 
|OPTEST |Tests the output string and moves text to the output. | 
| | 
| Pict {Diagnoses a picture. It uses a TRT table set up for the purpose. | 
| 
| PREC {Diagnoses the precision, and the attributes and format items which | 
| juse it. | 
| 
| SOFLOW {Bumps stack pointer and checks for stack overflow. | 
i ca a a a er ee 
Table CE. Modules CE, CK, CN, and CR Read-In Keyword Block 
Sa a a a a a a a ee ee ee ee 1 
| Function | Subroutines | 
aa nn a nf nnn nnn nnn nnn 
| Provides tables of keywords in internal | None | 
|code, together with replacement code. | | 
[No functional code exists in these modules. | | 
|Refer to Appendix B for details of keyword | | 
|tables. | 
Li. an ae oe eee Ce De oD ee PS A A SS SS SP SS eS ES A ED a cs en ee Se cr te i sw sleeps iis es we Sc inc eee a ee a ee eee: | 
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Table CI. Phase CI Read-In First Pass 


oS er ra oe eee ES Se ae Se ee ee aaa | 
[Main Processing| | 
; Statement or Operation Type | Routine | Subroutines Used | 
~------------------—--—------—-- }--------—-----+}-----—---—---------------------—- 
[Controls main scan, identifies | RSTART | ASSIGN, BADST1, BEGIN, DO, 
|statements, and analyzes some in | |ELSE, BUMP, END, EOP, ERROR, IF, | 
|detail { |ON, POPLST, PROC, READ, SIGRVT, | 
| | |STAT2, STRING, plus those | 
\ | |jsubroutines contained in modules CA| 
| | [and cc | 
buses tee ee ee eee eee ee eae eee ee eee eae 
Table CI1. Phase CI Routine/Subroutine Directory 
So rer Se sent er a ereasS eee eres 1 
| Routine/Subroutine| Function | 


eer re ee ef a nn nn i nr | 


JASSIGN (CG) 


| 
| BADST1 


| 
| 
| 
{ 
| 
| 
| 
{ 
| 
|SIGRVT (CG) 
| 

|STAT2 (CG) 
| 

| STID 

| 
| 


s 
STRING (CG) 


{Diagnoses an assignment statement. 


| dictionary. 

acaae SIGNAL and REVERT statements. 
|Handles all other statements. 
[Statement identifier routine. 


|Scans character strings. 


, | 
{Recovers from failure to recognize a statement type; skips to next | 

| | semi-colon. | 
| | 
|BEGIN (CG) |Checks the BEGIN statement and makes an entry in the first pass | 
| | stack. | 
| | 
| BUMP [Advances the input Data Pointer (DP), skips blanks, if any, forcing | 
| |source text to be read into storage as necessary. | 
| | 
|DO (cG) |Checks the DO statements and makes an entry in the first pass stack. | 
| | | 
[ELSE (CG) |Unstacks an IF compound statement. | 
| | 
{END (CG) |Processes three different types of END statements; PROCEDURE-BEGIN; | 
| |\DO; iterative DO. | 
| | | 
{ENTRY |Processes ENTRY statement. | 
| { | 
| EOP |Processes end-of-program marker, and returns to compiler control in | 
| jorder to load next pass. | 
| | 
|ERROR (CG) |Handles false starts on possible statements. | 
| | 

{IF (CG) {Scans the IF statement and makes entry in first pass stack. | 
| 7 | 
{ON (CG) |Diagnoses the ON statement and makes entry in first pass stack. | 
{ | | 
| POPLST {Removes prefix options from the text and places them in the | 
| | dictionary. | 
| 

PROC {Scans the PROCEDURE and ENTRY statement and makes an entry in the | 
|first pass stack. | 

READ |Reads source text into storage, translating it into internal code, | 
jexcept for character strings; removes comments; prints source | 

[listing and prefix options. 

RSTART {Controls the first pass scan. Enters statement labels into the . 
| 

| 

| 

| 

| 

{ 

{ 

| 

J 


tt ae ts EP OS OOD ogee ae oan dl eee cae eee ae ee ee cee eee es eo en ee es ee ee ee ee ee oe ee oe ee oe oe rr een ee eet ee ee eee eee 


Table CL. 


| 
| Statement or Operation Type | 


Phase CL Read-In Second Pass 


(C= — ae eee 


]Main Processing| 


ae on ee eee a eee ae ara aca el ae hi | 


Routine | Subroutines Used | 
{Scans for statements handled in |SCNA | BUMP, DELAY, DSPLAY, DO, FREE, | 
{this pass, analyzing them in | |GOTO, ITDO, LABEL, PROC, RETURN, | 
jdetail. Skips over other statements | |TRTSC, plus those subroutines | 
| | |contained in modules CA and CC | 
Ree ee eek eee eeaak Mi eh eo ee ea ee eee ta 4 


Table CL1i. 


Phase CL Routine/Subroutine Directory 


|Routine/Subroutine | 


fm nn enn ann nnn annmmnmend 


|Increments the input Data Pointer (DP), skipping over blanks, | 


| BUMP 
! 


| 

| DELAY 
| 

| DSPLAY 
| 

{DO 

| 

| EOP 

| 

{ 

| FREE 

| 

| GOTO 

| 

| ITDO 

{ 

| LABEL 
| 

J OPTION 


{ 
|PROc (cM) 
| 


| 

| RETURN 
| 

| SCNA 


| 
| TRTSC 


Me i ein: So ae ace ease ne cle mee aes ec eee OP ae ee ee en oe a ee or en a ee a> a em ee Gn ane re ee Eas oe eee eee ee en eee a oe On on ee OP On a oe ee a ee eee oe 


j obtaining 
| Processes 


| Processes 


| Processes 


| Processes 
|CS, or CV 
| 


| Processes 


| Processes 


| Processes 


| Diagnoses 


{Handles OPTIONS attribute on PROCEDURE or ENTRY statements. 


| diagnosis 


| Processes 


Function 


a new text block if necessary. 
DELAY statements. 

DISPLAY statements. 

DO statements. 


end-of-program marker, and releases control 
(CO and CS are optional phases). 


FREE statements. 
GOTO statements. 
iterative DO statements. 


LABEL attributes. 


jAnalyzes PROCEDURE attributes and options, and completes the 


Of PROCEDURE and ENTRY statements. 


RETURN statements. 


|Main controlling routine of this pass. 


|Skips over all other statements. 


to phase CO or 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
! 
| 
| 
| 
J 
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Table CO. Phase CO Read-In Third Pass 


pF eat pe teagan gg OR 8 8 oe ea ty ho Ra nee ot et ee edd, Se a me Ee ip Ae ew an © Mera ay eee eee 


|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 


+ 
{Scans for DECLARE, CALL, and | SCAN2 {ATTLST, BUMP, CALLOP, DECL, DEFIND, 
[ALLOCATE statements. Analyzes | |DIMS, ENTRY, ENVMNT, EOP, 

|syntax of attributes by calling | {GENRIC, LABEL, LIKE, USES, IVLIST, 

{appropriate subroutines | Jand those subroutines contained in 
| | |modules CA and CC 


Ca ae ee ee re ee ee me ct ee ee ree ee en em ren ewes we we ee cen an arene doen co en oe or ee ee eran en a ade ean ae eee ee me eee eee wen wooo I 


— ee 


Table CO1l. Phase CO Routine/Subroutine Directory 


[Routine/Subroutine}=———s—=<“<s~s=‘< ; 2 2C~S*éNCHGCNOO!!U!U!U!U!U!U!U!U!!!!!CS& 
inpinsay ” beocekeea an aceite lise, Gecdieive) = i 
{BDCL ieécdaues DECLARE or ALLOCATE statement. 
| BUMP taaguaeee Data Pointer (DP), obtaining new input block if necessary. 
‘cunuentien iateees CALL statements and options. 
jDECL . ee the DECLARE and ALLOCATE statements. 

TSEE LA eee the DEFINED attribute. 

ae geaeunee the dimension specifications. 

| ENTRY |Checks the ENTRY attribute. 

JENVMNT (CP) jRemoves environment information from the text and inserts it into 


{the dictionary. 
| 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| | 
| FOP jProcesses the end-of-program marker, and releases control. | 
| | l 
| GENRIC {Processes the GENERIC attribute. . | 
I | | 
JIVLIST (CP) {Processes the INITIAL attribute. | 
{ | | 
{LABEL (CP) {Analyzes LABEL attribute. | 
| | 
| LIKE |Processes the LIKE attribute. | 
| | | 
{PSGUID (CP) {Checks for a qualified subscripted identifier: in parenthesis. . | 
| | | 
[REFER (CP) |Checks the REFER attribute. | 
| | | 
| SCAN2 j|Scans for DECLARE, CALL, or ALLOCATE statements, moves others to the| 
! Joutput string unaltered. | 
| { | 
| SCANT {Moves text to semicolon without alteration. | 
| | 
{USES pBeretee the now obsolete USES and SETS attributes from text. | 
ia i a a a i a a ac a ee a one et ne re ee _J 
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Table CS. Phase CS Read-In Fourth Pass 


re a ee ee Si a la aR a aa a a a a 1 

|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
PS see eee Ah ne Rs ENP 4-~--------~-~~-} ~~~ +--+ ~~ +--+ +--+ +--+ +--+ 
jControls main scan and identifies |SCNA pes FORMAT, GET, LIST, OPEN, : 
{1/70 statements for further analysis| |READ, TRTSC, plus those subroutines] 
| | |contained in modules CA ani CC | 
ba Se ee eee eee eee ease ee mare eer ea one crear Lone een wo eee J 


Table CS1. Phase CS routine/Subroutine Directory 


|DELETE. This routine also checks for permissible combinations of 
jthese statements. 


 paeGennasinies conic . aS eG eee ee ee eee 1 
| Rout ine/Subroutine | Function 
pea nnn nn nnn nnn nn nnn nn nn nnn mn nnn nee : 
| | | 
| EOP | Processes end-of-program marker and releases control. | 
| | 

|FORMAT (CT) | Processes the FORMAT statement and format lists. | 
{ | | 
|GET (cT) |Processes GET and PUT statements. | 
| | 

J LIST {Processes data lists. | 
| | 

JOPEN (CT) {Diagnoses OPEN and CLOSE statements. | 
| | 

READ |Checks the syntax of RECORD I/O statements READ, WRITE, REWRITE, and| 
| 

| 

SCNA {Main scan of this pass. | 
| 

TRTSC |Skips over all statements other than I/O, moving them to the output | 
|text. | 

aerate regent pee ear rab arena evn eee a ie ee oe ee eee J 
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Table CV. Phase CV Read-In Fifth Pass 


Cris se gt gh Oe SPAR G LNW EF bse gO ol Ng hom OO ae een Pg ite 


| Statement or Operation Type | 


{Main Processing] 


Routine | Subroutines Used 


Sn ae 


JIdentifies statements for which it |SCNA 
|must build chains 


| CALLIN, CHAIN, DECL3, DO3, END3, 
| JENTRY3, EOP, POA1, PROC3, TRTSC, 


| Jand those subroutines contained in | 


| |modules CA and CC. 


bawie ees eo ee oe ee a ea eee eee J 
Table CV1. Phase CV Routine/Subroutine Directory 

[Routine/Subroutine] + ~~~~~~+~Function—(‘“‘séSOCOO!O!;~;~;!C*@* 
ICALLIN (CW) [Makes up the CALL chain. si—(‘(Orté*é*é‘ SéS;CO!O!!!!C~™ mae 
\CHAIN {Forms chains. ! 
reesexon aneee the fifth pass stack for ON entry, in order to insert ! 
| | PROC-END statements round the ON unit. | 
eee |Chains the DECLARE statement to the appropriate PROC or BEGIN 
| | statement. | 
|D03 iaaeee a stack entry for DO block. 
or raneaes the fifth pass stack. 
ore rushes an entry in the ENTRY chain. 
oe (CW) ieretedtee end-of-program marker, and releases control. 
| ILABSN (CW) jCreates pseudo-assignment statements for initial labels. 
taoad |Analyzes prefix options in greater detail. ! 
Nene roesueteee check lists. ! 
‘saoes j|Makes an entry in the PROCEDURE-BFGIN chain. 
iseun {Main controlline routine of the pass. ; 
seus |Extracts statement number for label entry. | 
iiaeee ee over statements not required for analysis in this phase. — | 
eee I ea a ne | 
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Chart 03. 
SCOSSCAL OSHS ESEESe 
CINITIALIZN EG* 


ppahpa 4 ee et ee 


s 

6 INSERT TABLE * 
NCHNS® 
COSTE OSES OS ECEEE 


steeeBisscerseces 


ENTRYS 
° EMAILS 
Seb eesesesesecess 


eheesCisseseceece 
*DECL PASS 1 EI¢ 
o-0-4-8-% 

*SCAN DECL CHAIN® 
*PREPARE ATTRIBS* 


*FOR NEXT PHASE * 
SOCo CO SHE SEE SEESS 


SOSSEH1L OOS SE OSESE 


qDECL PASS | 2. EK* 
a er s-6-8 


sScan DECL. CHAIN? 
*MAKE ENTRY FOR ¢ 
*EACH DEC VARIABS 
SHCHCRESE REESE EES 


OCSCEE LES CERO S EES 
SCOMMUNTCATNS EPs 


oSET LATE PHASES* 
SMANTED OB UNWTD* 


SHEERS SESEEESE DES 


OeSCEPIL CCS EOSEESES 
SSGAN ENT TYPE 23 
CHN MAKING ENT * 
STYPE 2.6 +5 DIcT¢ 

FOR DATA ¢ 


ENTS 
or¥P RET BY PROC* 
CORE SESESESE SESS 


$ESSEG1 FOO CES O EES 
* L 


* 
SHEHESSHHSSVSSSES 


HL *, SHOSSHZe sesessess 

-* DOES #*#, *LIKE + 

# PROGRAM s, Ss Pe ee ee ee ee 
*. CONTAIN LIKE .%-------->*SCAN LIKE CHAIN® 
*. ATTRIBUTE. * * EXPAND ALL * 
*, o# *LIKENED STRUCTS* 

e*. .# OFSSTHSEESCEHESCEES 


J1 *, PeeeesZECeseseees 
Phd *. *ALLOCAT Eys 
-*ALLOCATE OR*. YES 0+ - 6-6 -8-86-9-8-8 
*PTR. IFIER. *--. wnonan> SCOPY DIcT ENTRY* 
*IN PROGRAM. * *OF ALLOCD & PTR* 
a. a sou LSe 
e. 48 rrryviririrtitiy 
* NO 
FR nn etal eae NTT 
SOCHHK1LSE SOSOSSEOE ore akee piers 
SCONTEXT FA* : MAKE DICT bd 
paren derpeciga canciayial Sadt doatoansed ENTRIES FOR *# 
*SCAN TEXT. MAKE*~-~--- ~->$coNSTANTS USED *----- 
sane FOR _COND . *IN THE PROGRAM be 


AMES § FILES 
sencenseseseeeees 


seesevscceceseces 


Dictionary Logical Phase Flowchart 


SoOseAIeeesersece 
gBgd<bict REF FES 


SCS HEREC EHEDESE 


SHSEABIECSEeoness 
Fis 


*CHECK 
e- Cyr arecdcextesne 


SCHECK VALIDITY * 
oF pictacrers : 
: EFERENC 


sdécrebocsnicoses 


-*, 


° 


SO SSOCKSeoroeeEES 
SATTRIBUTES Fke 


er 
“e. YES  =«-_«_s# #8888 e-se8 
*LATTREBOTE. IN, {e2ta_--->8BROCESS. SETS & * 
*. ,PROGRAN USES LISTS IN ¢ 
: STHE DICTIONARY. * 
"e. * SHSCEHTECEEEE DEEDS 
*"No 
Rew e ce oe ee enw wn wo we wn ne es 
sree ese seeneeees 
N ‘6 
cecécéaectaeusce 
*CONSTRUCT DIcT * 
ENTRIES FOR * 


* ON-CONDITIONS * 
SCSCSEEOEEESS BEES 


SOCCSEI SR CEES OETE 
* REPLACE BY AN * 
*ERROR STATEMENT ® 
* ANY STATEMENT ¢ 
SCONTNG A DUMMY *¢ 
*DICT REF. * 
Sh SCee te eee eases 


F3 
-* AN «, 
PICTURES #. 
IN THE s 
*. PROGRAM .* 
*. + 
s, Vf 
* NO 


om 


CONSSF USS oseseres 
SPICTURE | s 
~t—-t-t—-t- s- 3-6-8 
>8CHECK VALIDITY * 
* OF PICTURE * 


* 
SSESHSESV ESS ESE SSS 


@aseiion nee saue 


06868639 660s 80008 


SHOUSEKEEPING F rT? 


*CHAIN VARIABLES? 
*OF + 


EACH STORAGE 
*CLASS & CONSTS * 
OSCE SO CESOOEE EEE 


SOSSSHIVS SHE SEEee 
* UNCOMMON * 


* _PICTURE AND ¢ 
*DIMENSION TABLE* 
. DICT. ENTRIES * 


SSCSHSHSESSESE SETS 


CeCe e TIERS SERSERe 


* 2ND PILMRGE ve 
Ho F-4- $2 t—-9-4-8-6 


pais 
SAETER ALLOCATE amen BRTENTS 0 


OC OR BEGIN * 
: v STATEMENTS s 


sesee meceeeese*? 
TABLE . 
qBASED VARIABLES® 


oeeeeessasesseses eeiesessecenscess 
§ pacceseacsscscced meaccheun 
K3° bOCKYsesenaseses 
* ATR 
-* OR XREF *. YES * PRINT ATR ¢ 
*, ISTI « Fe ee ene > AND/OR XREF 
*. REQUIRED .¢ + “LISTING * 
*, 6 eee eeereeseeceee 
* NO 
Ses eese 
| 204 204 6 
->* Bl * ->* Bl e 
> ° » 
ees ates 


Chapter 3+ Flowcharts, 


Tables, and Routine 


Directories 


Chart EG. 


120 


SOHSAL OOF ERD ESOS 
‘ 


e 
* 
* INITIALIZE * 
: HASH TABLE 
® 
e 


eee 


$9 04068466864649 


CAAL 
CEL dadad =} Sedededadadadndndada 
* INSERT LABELS * 
*IN HASH CHAINS, * 
* CHECKING FOR * 
bd MU LE 


LTIP. * 
EFINITION ° 
O94 68 6S CERES ORTE 


Phase EG Overall Logic Diagram 


SOSSEDAYUSeSoseeese 
* 


ENTRY 


eeoene 


* 
* 
* 
5 
SOSSSASSOSesEesEs 


SoeeeDysoessvesses 
* tOVE 
* ‘SUBROUTINES 
* INTO SCRATCH 
* CORE 


eoanee 


SESHSESHTES OES EEHE 


CA7 . 
PEER Tepe EEE LES EE SF 
t * PSOSCht+Fesesesse 
* SCAN * * RELEASE * 
* PROC-BEGIN ¢ * CONTROL . 
. CHAIN . * * 
» ¢ sees $3OSSSEHTSESEEES 
PESES TEPER ET SESS F * * 
: * p2 * 
O22 * s 
* * ee46 
* D1 +> 
2 * 
SHOE 
<5 CAPROC RP CTYPBL 
D1 *, SESHSHZ eb eseuses SO64S)3S FESR 89688 SESCOPYSESseseese 
. +, * * * SCAN FORMAL * *SCAN ATTRIBUTE * 
~* *, YES * GENERATE * *PARAMETER LIST * * LIST. CREATE * 
*, PROC etmenne--->* ENTRY TYPE 1 *#-------->* AND CREATE *-------~->* ENTRY TYPE 2 
*, * + * * F.P. TYPE 1 * * FOR THE * 
*, 4 * * * ENTRIES * *STATEMENT LABEL* 
*, 9 PEE EEL ESET ET EE TE FY 2SSVTS$HERESHHSERSESE $$O8SSERESSESEREDSE 
* WO 
4, 8A 
El +, SOERSE LS OS VV SHEDS SHSHEE TCHS SESE 
.% s * * 


.* “oe. YES * CREATE * * CHAIN 
1, BEGIN |. #==--~-=->¢ ENTRY TYPE 1 ¢---~---->* ENTRY TYPE 1 


% e 
*, .* * * 
*, .* SECEDE S EDO SESEDEE 
* NO 
seen 
| sEI * 
>* A2 * 
* * 
seen 
NOTE: 


GOES TO PHASE EP 
If THERE ARE NO 
DECLARE STATEMENTS 


eeeee 


s 
SFSESOHESESEEEODEE 


SesesT3eseseeeses 
e * 
* UPDATE bd 
bd MAPS TACK * 
* * 
* * 


SSSSESOHSE EESESESEE EY 


eee ewe ne> 


SOeFEHHeeseesoose 
s 


* 
* VARIOUS bd 

Bann neen->* ENTRY DICT be 
* ENTRIES *. 

* * 

s 


SSCS eseseessesee 


SHODEES SC OSES eCO8 


on UPDATE bd 
* \MAPSTACK IN * 
* SCRATCH ° 
: STORAGE : 


PERSE PLETE TET 


TYPw 
SCHSSPOSOH SRE COOED 
. 


SCAN 
ENTRY CHAIN 


eaent 
eeee 


SHHSHETESSSOHE DOOD 


Chart EI. 


Phase EI Overall Logic 


CCGSOO 
SCRSSAZO OS EEEEOES 


SCANS 
SOURCE TEXT 


eeone 
enene 


SHSESHE SHEESH ESEOEE 


eee eeeccleS. 


CCGSE 

emai 1h grt dad 
* PICK U 

3 NEXT ENTRY 
$ IN DECLARE 
€ 
i 


eeaae 


SOOCCEHHEOSEEEESD 


Cae mie aiewan te 


FOR 
FACTORED o Henne 


Diagram 


one 
° Py 
¢ BU 
* * 
eoee 


Knee ecw enn ea 
ccGs2 
SPeeeRzeveseseses 
PS 
* Cont thar 
* SCAN OF 
. DECLARATION 
. 
| 
A 


* 


aeee 


SSSCSCTES OT ERHSESDS 


CCFLP 
seebScgeseens cans 


TEST FOR: 

CHARACTER, BIT, PICTURE SOS ED Ie SESREESES 
USES, SETS betrin NED, ¢ PARTIALLY ¢ 
POSTtIOn, LIK PROCESS THE * 
DYMENSroks TURETIAL, wae ene > ATTRIBUTE TO $-~~ 
INITIAL CAL ABE - ASSIST LATER *¢ 
BRE BISTON Of FSET * 
BASED AREA oestes obeteeteees 

NTRY 
SSSHHE SSC SStESEE 
ST “s. * KEEP A COUNT ¢ 
FOR +. YES OF THE . 
ENTRY OR | #-------- >SPARENTHESES TO *--- 
GENERIC .* *ASSIST FACTORED* 
*. 76 *ATTRIB! + 
e, .e PT Str Ti TTT it Tt its 
*" NO 
-*, 
F2° "#, 
-* TEST *. ees 
.* FOR *, NO * 
*: END OF Tellee>e B3 
*, DECLARE .¢ * Ps 
*, * eeee 


*, .t 
* YES 


A , 
a 
7) 
« * o ° 
oe ee > . 
hee 228 Ey 
* * #5 Rae | ‘ 
a. £38, 2 2G .28, 
ror * ° Q Rann * 
. ze . z*4 a 
: eo = : 
* . e « 
*< < 
& : 


H 2 . 
1 e* TEST ¢. 
' No. OR E . 
Lew=-@, OF DECLARE .* 
° HAIN. 
é 4 
*.. 
* YES 
ees¢ 
[ *EL * 
->9 Al * 
eee 


Chapter 3: Flowcharts, 


Tables, 


and Routine Directories 


121 
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*, -# *, * id TO OUTPUT bd 
*, ¢ *, .* * 
+. .* *. SECSEECERD ESO OEES 
* NO * 
o%. Fvi8 
fl *. SCeCEPI GRC seCeEEE 
-* *, + SCAN * 
* *, YES * ALLOCATE LIST * 
*,. ALLOCATE » Pawnee =~ >*MAKING SEPARATE*<--—~—~~-~-~—~~~ — 
#. * * STATEMENT FOR ¢ 
*, -* bd CH I * 
o 8 POSES ESSEC REEDS 
* NO 
NO 
DATCPY 2%, 
SOSCSGIEbESEESEES G3 *. 
* ADD 2ND FILE * * * 
*STATEMENTS FOR * END - YES 
EACB IT ¢-------- >, OF LIST 2 t--- 
UTP * 3 . 
* *, + 
Peeeseerecesesere *. 4 
* 
4, Fv19 DATCPY ; 
HL *, Seeven2eesssvsses SSSSSH IO eseseeess 
-* +, * SCAN CHAIN * * IF _ LABEL * 
*. YES *OF ENTRY TYPES * * RETURNS * 
*. PROC . >? FOR ENTRY #-------- >* ADJUST STRING * 
*. Pid * LABELS * * ADD 2ND FILE ¢ 
*, -* * * *STATEMENT TO OP* 
e. 4 Seseeesecessseses SPECHT ESSE SEE CEES 
* NO 
| YES 
-*, FV20 FV34 DATCPY 9, 
31 *, SESE TIC CESSES SSSOSTIOCSSEREESS SOeeeegeseseceses a5 e, 
a ‘ YES : PICK UP : * SCAN AUTO ¢ SPTLE STATEMENTS * o* pnp *s 
* *, 3 . % 
*, BEGIN a orn ——->* ENTRY TYPE 1 #-----~-- >e CHAIN FOR ¢—---~--->*FOR VARIABLE TO*-----~-->%. CF CHAIN * 
*. hd * * * BLOCK bd bd OUTPUT id *. id 
*, -* * * * e ¢ e *, .¢ 
*, , SESSSSS SSE OESESES Seeeesesesesseses Coeeesesesesesess *, .* 
* NO t i NO 
-*, 
K1 +, 
. +, 
NO... *. YES 
=F, EOP Pees 
* Pd 
*, * 
*. 4 
* sees 
FX # 
A2 
* 
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Chart FX. 


134 


Phase FX Overall Logic Diagram 


SSOSHA QA ECS sEseees 


* STORA AND 
*TEXT BLOCK FOR * 
* SORT TAB * 


BOSSES ESEEEESES 


, ers oe wee eee =< Ot a en rw wn a on ee re ee ees 


NO 
Fx0000 4, ‘I. 
SESSOD2 00S eeesse* Boe ara TT caeebudeeass FROg38 ES *. 
2? * > . , 
* SCAN STATIC *# *ATTRIBUTE, *. ¢ id -* ENC *, 
* CHAIN $-------->*COMPILER LABEL rete _--- os SORT EWTRY Senne ---- >*, OF CHAIW .° 
* N CONDITIONS” * e, .? 
* NA E, * *, .¢ 
seseeseceeseseees *. eudecevaseceuanse o,f 
{ * “YES | Yes 
FxX0100 
SEteeCZ eee seeeees 
* 
SSCAN PROC-BEGINS 
CHAIN We nanin aici es duescosanaetneracetaccess meee wacweesaccascctuss sasaeescs 
b4 
* * 
SESSA SESESE SEO EEE 
YES 
-*, *, Fx0120 of, 
D2 +, D3 *, SESH EHUSSsesesees DS e, 
* *, * *, * e .* *, 
.* END *. NO ANY *. NO *SCAN AUTOMATIC * -* END *, 
+. OF oe ae * PARAMETERS @ Baw enen-= >* CHAIN bE leet >*, OF * 
*. CHAIN .* * A * *., CHAIN .* 
. .* e, Paid * . . ° 
e. .* *, ,@ SCHOO SESE DE LOETES *, 16 
* YES * YES A * WoO 
oeee 
* * 
* E2 #-> | 
* #  [€-2--~----- 
o448 
Fx0170 Fx010 #, 
SOSSHEQ FSR SEREEEE +e Lee EIS te0seceee ES *, 
SCAN CONTROLLED* : YES .¢° “BCD ON et 
. +, 
* CHAIN * * PARAMETERS toes cn ia ek nian ed err alam toey Fg DiITT Ten te 
: * : A enTey, 2 PE.* 
SOSHSESORERESEESS seeceeesccoseeees a 2 
* "fo 
4, *%, Fxo 
rH R eapissessseres F? +. 3 +.) gocserne eeeeenes shheerseseseceees: 
* ° . * e 
* YES .* END OF *. NO » sALLOcATION” *. NO bd bd * * 
“noe SCAN TEXT $€-- eat, CHAIN ¢ Seine 8 eecee---->* SORT ENTRY * eanee8 SORT ENTRY * 
: . x *-PARAMETER.* : : : 
SOHSESEEHE DE DEOES a a a Sheoeseesaseseses seaseceseessesess 
* * 
eens | at Poe 
* » > s 
* G2 s-- —->* E2 * 
* * ? * 
ee8 eoe8 
«*, FXPRNT FXBCD 
Gi *, Sesesassecexesnte SOaGZteerseesess 
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-* END OF *,. YES * PRINT BCD * 
+. TEXT 1eZES_-———>sscan SORT CHAINS-—-—--~->, AND DCL NO. 
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*, .* sess 
*, 4 seeseseesscsasens SOSCRREDE DESEO ES . * 
«NO * G26 
* * 
eose 
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| No 
8 4, -*, ae 
al e, seosenzesesesesse n3 *. nu *, HS *, 
.* +, ADD STATEMENT * * *. .* *, .* *. 
NO. *, YES *NUMBER TO CHAINS * ATTR *,. NO id XREF *, NO -* END OF 
<-<-#, DICT REF sPacnann——>$ FOR THIS DICT : +, LISTING 2 Beene = >, LISTING oF eee n = >*, SORT -* 
+, * ENTRY *, REOQD Pad A *. REQD * A *, CHAIN .* 
*, .* : : *. * *, ‘ *, .¢ 
o, ,* SOERSEEEEESEEDESE *, ,¢ ec *. 4 
* * YES * YES * YES 
eoee 
| sca 
->* Al * 
* 
sees 
REFMOV 
papi b thas SOOT IESE SS EEEERF Sea TUTES SE SESESS 
: a TEM * 2ocan CHAIN OF 
S SASED. TO ¢ * PRINT * STATEMENT 
wannnnnnnnn neem nnnnen anno SCHAIN FOR DICT * ATTRIBUTES casas NUMBERS AND | hin 
ENTR Y OF ‘ * PRINT THEM 
Seeneneessaneeees eheesseseasesees SOCCER RESEEETES 


Table ED. Phase ED, Initialization 


Se ee ae re re ee Se eee aaa ia ay 
{Main Processing | { 
| Statement or Operation Type | Routine | Subroutines Used { 
}--~----~---------~~---—-----—-~----—- --} ----~-- --- ----+- 4 --- ---- - -- -- + ee + 
{Sets up routines in scratch storage|SETUP | None " 1 
|for phase EL | | _ | 
Re ee ee A oes esa ties lc ec oe catia hi aa nel saenlo el cape -J 


Table ED1. Phase ED Routine/Subroutine Directory 


| Routine/Subroutine| Function t 


p——= = — fen ane ara ence meme eee —-+{ 
{EVENT | | 
| TASK | 
| CELL jRoutines for processing declared attributes. These set up | 
| BASED }information in the attribute collection area of scratch core, 1 
| POINTER |for reference by CDICEN, etc., in phase EL. ! 
| OFFSET { | 


Table EG. Phase EG Dictionary Initialization 


I a a a a Ra CR SS, eGR SGI AD agama ea i 7 
|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
|}Hashes labels | CAAL |CHASH, CBCDL2 | 
| PROCEDURE-EEGIN chain |CA7 | None | 
| BEGIN | CA8A {None | | 
a ee ae a ED ee aD GD ee OD ee ee ee ee ee a es oe ae ee eee 4---------~----— PS NS SENG OO ce EY ES een AT SE SEO EE ET ES ED OES ES NE AE GO EE PE aE ae 
| PROCEDURE | CAPROC |CANATP, CFORP . | 
<P ee ie ae SY Ge eee CES Oe Se ce ae oe ee ee ee ee ee ee oe oe ee een ee ee eee eee ae 4+~-----~—--—-= ees ew ee eee oe ee ewe eee SE ES TR NE EIS ED SO EN Se I eee | 
| ENTRY | CALO |CANATP, CFORP | 
wa an an anna nn nn nna nn nnn nnn nf nn nn nnn el 
|Formal parameters | CFORP {|CHASH, CBCDL2 . | 
jJAttribute list | CANATP |CAPRE1, CATCHA, CATBIT, CATPIC | 
|---------—------------- ---------- --} -- = ----- == enn nnn nnn nn 
|Creates entry type 2 entries for | CTYPBL |ENT2F, CDEFAT | 
| labels | | |: 
a a se Se as a eee eee cm ee ee Se a SD SAN AY RY DS A a ea a 5 2 ae ee eee ae Ge a Oe cc ee ee ca cs tees occ es os ams coc es 
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@Table EG1. Phase EG Routine/Subroutine Directory 


Ge gs) a ee ee aaa aE I a a ag a CR AST aA ce MR | 
| 


Routine/Subroutine| Function | 
[cal ~~ |Scane label table and hashes labels» = ~=~SSSSCtC~CS<(;<SsSt 
| CANATP {Processes attribute list. 

| CAPROC ceeeaes PROCEDURE statements. 

| CAPRE1 | Processes precision data. 

| carart eee BIT attribute. 

| CATCHA isEosezees CHARACTER attribute. 

woe | Processes PICTURE attribute. 

|CA6 (nee the PROCEDURE-BEGIN chain for the relevant statements, and 


.|sets bits in Dictionary entries for optimization options on 
| PROCEDURE and BEGIN statements. 


| 

I 

tence |Processes BEGIN statements. 

joa |Processes ENTRY statements. 

lcacone: resyeeees the hash chain looking for entries with the same BCD as 
| . jthat just found. 

aoe ‘ ecapaaees data byte for entry type 2 entries by default rules. 
\enaee |Processes formal parameter lists. 

| nee JObtains an address in the hash table for an identifier. 
een etesies entry type 2 entries for labels. 

oe ' |Creates or copies second file statements. 

ee iecans ENTRY chain. 

ropa (EF) {Checks containing block options, for inheritance. 

lacus (EF) [Processes procedure options. 

[OPTN3 (EF) eran post processing, makes STATIC DSA decisions. 

aeeee (EF) ipegsesues POINTER, OFFSET, and AREA attributes. 
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Table FI. Phase EI Dictionary Declare Pass One 


|Main Processing| | 
| Statement or Operation | Routine | Subroutines Used | 
wa nn nnn nnn nnn nn nnn nn fin nnn nn nnn nn nnn nnn nnn nnn nn nnn nnn nnn nnn 
[Scans DECLARE statement | CCGSO | None | 


}---------------------------------—-} ---------------+} ------------------------------ === { 


|Scans text | CCGS2 | None | 
| Processes structure level | CCGSCM | None | 


SN es Oe ee 


|Factored attribute, left | CCFLP | CFPMCR | 
|parenthesis | | | 


Seer LEE UTGEiPP=SIPapREDET SAP UEREREEERETEEETEREE: o=TEDSRERRTRERTEREREEn S>NEEEEREEREREERRERERRIE EERE + 
|Factored attribute, right | CCFRP | None | 
| parenthesis | | | 


+ + 
| POSITION | POSIT | None | 


noe i ee a ef ef ee 4 


|CHARACTER, BIT | CHABIT | CTXTRM | 


Ce ee 


| PICTURE | CATPIC | None { 


4 
| LIKE | LIKE | None | 


| KEY | KEYED | None | 


ca as a A A ED a A NE ND ED SS ED ES EE ED SE ae DO et TD eS aD a TE RN SH aD MOTD EP OR oD en Ha a a nr a eH  -f 


| Dimension | CDDIMS |CTXTRM, AST, TOMENE, ERRORB | 


a nnn nn nn naa fn ann f nnn nn nnn nnn nnn nnn nf 


| Precision | CDPREC |ERRNEG, SCLBIG | 


I $ -++ 
{INITIAL CALL | INCALL | CTXTRM 


oo ne a ae ae ee a ee er re a eee a ee a ree ae ee es eee a es eee wa a ef a |] 


| OFFSET | OFFSET | CTXTRM | 


t + + | 

| EASED | BASED | PTVEXP | | 
mann nn an nnn nnn nn nnn nf nn nnn nnn nnn nnn fn nn nnn nn nnn nnn nnn nnn nnn nnn 

| AREA | AREA | CTXTRM | 


i Le en ne 
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Table EI1. Phase EI Routine/Subroutine Directory 


(aor eee 
| Routine/Subroutine| 


Function 


a an fm a nn ne = | 


| AREA 
{AST 


|BASED (EH) 
| 


campae 
coe 
Scori 
ieeeae 
Vceasen 
| CCGSAT 
Veeése 
\éeas0o 
free | 


| 
|CDDIMS (EJ) 
|CDPREC (EJ) 


I 
|CECON (EH) 
a 


| 
| CFPMCR 
| 
| CHABIT 
| 
|cSGso0 


| 
| CTXTRM 


EHINIT (EH) 


JEJINIT (EJ) 
| 


| ERRNEG {Deals with the case of a negative precision specification. 
| i 
| ERRORB |Deals with the case of lower dimension bound declared greater than 
| {the upper bound. 
Lele ee oe he ee eee mene ee owe eee to eee a ee ee ea eee eS 
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{Processes AREA attributes. 


|Deals with the case of* dimension bounds mixed with non -* bounds. 
| 


|Entry point in OFFSET routine, at which second file statement is 
|made. 


{Processes PICTURE attributes. 


| 
| Processes data following DEFINED attribute. 


| Processes factored attributes (left parenthesis). 
| Processes factored attributes (right parenthesis). 


| Processes structure level. 


|Attribute routine selector. 


{ 
|Scans DECLARE chain. 
{ 


{Scans text. 


{Scans source text. 


|Processes dimension attributes. 
|Processes precision attributes. 


|Makes a dictionary entry for a constant unless one has already been 
jmade. Returns the dictionary reference of the constant entry. 


|Obtains more storage for the factored attribute table. 


| 
| Processes CHARACTER and BIT attributes. 


| 
{Detects end of DECLARE chain. 


j|Tests for space in current text block and obtains new block if | 
| necessary. 


{Processes the INITIAL attribute except for the initialization of 
{label variables and INITIAL CALL. 

| tt 

|Processes INITIAL attribute and LABEL with a label-constant list. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
4 


Table EI1. 


Phase EI Routine/Subroutine Directory (cont'd) 


|greater than 32. 


We Ee ee ee ee eS eee ee a ee eee 
| Routine/Subroutine | Function | 
| GENTRY |Keeps a count of parentheses in GENERIC and ENTRY processing. | 
| | 
JINCALL (EJ) | Processes INITIAL CALL attributes. | 
1 | 
|IVROOM (EH) {Checks if there is space in scratch storage for another entry. If | 
| jnot, it makes a dictionary entry and chains it to the previous one | 
| Jor to the C8 in text as required. | 
| | 
|IVPUTL (EH) |Places a dictionary reference in the ‘initial list’ for a label | 
| |constant. If the constant is not known, a dummy reference is | 
| | inserted. | 
i | 
|IVPUTC (EH) |Places a dictionary reference in tne ‘initial list’ for a constant. | 
i | 
JIVPUTO (EH) {Places the dictionary reference of zero in the ‘initial list' for a | 
| |negative or imaginary replication factor. | 
| | | 
| KEYED | Processes KEY attributes. 
| | | 
| LIKE | Processes LIKE attributes. | 
| | | 
| NEWBLK {Obtains new text block. | 
| | 
JOFFSET (EH) | Processes OFFSET attributes. | 
| 1 | 
| POSIT {Processes POSITION attributes. | 
| | | 
| PTVEXP (EH) {Entry point in OFFSET routine, at which secondfile statement is | 
| jmace. | 
| | 
| SCLBIG |Deals with the case when a precision specification for fixed-point | 
| |data is declared too large. | 
{ { | 
| SECON {Creates a dictionary entry for a constant provided the appropriate | 
| jentry has not been already made. | 
| { | 
| SETS | Processes USES and SETS attributes. | 
i | 
| TOMENE |Deals with the case when the number of dimensions declared is | 
I | 
L J 


Sa a tt ce ems lsc eit en cs ell rcs ci nnn ee nin we as cw mm Sms es ie cn ec smb wc comb am mio um eb <r Sm cs ts ems Gs seis i em in si i yas Sis ems a) 
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Table EL. 


Phase EL Dictionary Declare Pass Two 


Sg ee a ee ee ee et eee a a aaa a a a ae asa 1 

|Main Processing} | 
| Statement or Operation Type | Routine | Subroutines Used 
{Scans chain of DECLARE statements |CGENSC | CDCLSC | 

-~--~---—----------------------——}-----—-------- ----------—----------------------- 4 
{Scans each item Of DECLARE | CDCLSC | ATLSCN, BCDPR, CDFLT, CDICEN, | 
| statement | |CDIMAT, DCIDPR, INTLZE, POSTPR, | 
| | |SELMSK, STRPR | 


|-----~---------------------------—}---------------} ---------------------------------4 


| INTLZE 


{Initializes each identifier 
| declared 


| DCIDPR 
| 


a= ~- == - ~~ -- = === == --- 5 == === 22-2 =f on 2 =f 


{Processes factor brackets and level|DCIDPR 


| numbers 


| TEMSCN, 
| 


BCDPR 


------~---~---4--------------------------------- 


{Scans for next level number | TEMSCN | CDATPR | 
}--—--------------------—---------- ---------------} ------------—-------------—------ 
|Processes BCD of identifier | BCDPR | BCDISB, CHASH, SELMSK | 


SE en ee 


jHashes BCD of identifier 


AP IGS AS AD CS ED ES ES SD OE SS SS ES ES GS CL EE NS SP ES TD GAS SS ED AT OY EY UD ED GED ED GD a ae 


|Scans list of attributes following |ATLSCN 


jidentifier 


| CHASH 


| None 


wa naan ff on nnn 


{Applies factored attributes 


|Applies implicit attribute 


wf - + 


[Attributes controlling routine 


| 
| 
| 
| 
| 
| 
t 
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| CDFATT 
| IMPATT 


| CDATPR 


| CDATPR 


|CDAT44, 
| CDAT4A, 
|CDAT4F, 
| CDAT57, 
|CDAT61, 
| CDAT69, 


CDAT6A, 


CDAT42, 
CDAT48, 
CDATAC, 
CDATS5S, 
CDATS59, 
CDAT63, 
CDATB4, 


CDAT43, 
CDAT49, 
CDAT&D, 
CDAT56, 
CDAT60, 
CDAT64, 
CDATB8 


| 
| 
| 
| 
| 
| 
| 
J 


Table EL1. 


Phase EL Routine/Subroutine Directory 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
4 


[Routine/Subroutine| = sssS™S Function 1 
fariscn SS [Scans the list of attributes following the identifier. { 
ieee {Checks for multiple declarations, etc. 
a teseesels BCD of identifier. 

lepiee (EK) 1 aeegibave controlling routine. 

lopadas (EK) Seosesaee DECIMAL attribute. 

apariad (EK) |Processes BINARY attribute. 

perere: (EK). eee FLOAT attribute. 

emanas (EK) oer FIXED attribute. 

\ ona (EK) lceceaistis REAL attribute. 

jopmeas (EK) ipeeceseee COMPLEX attribute. 

Vepuneg (EK) j Processes precision attributes. 

|CDAT&8 (EK) esata VARYING attribute. 

lepatile (EK) | Processes PICTURE attribute. 

forerr (EK) {Processes BIT attribute. 

fore (EK) Voeeelens CHARACTER attribute. 

apanue (EK) euoees FIXED DIMENSIONS attribute. 
rere (EK) oe deueden LABEL attribute. 

porene (EK) eeeeeszec ADJUSTABLE DIMENSIONS attribute. 
oaks (EK) {Processes ENTRY attribute. 

ebaees (EK) eects GENERIC attribute. 

\cuanee (EK) eseseaes BUILT-IN attribute. 

lesavéo (EK) {Processes EXTERNAL attribute. 

lepinea (EK) | Processes INTERNAL attribute. 

\eoares (EK) |Processes AUTOMATIC attribute. 

Vannes (EK) [Processes STATIC attribute. 

iopknen (EK) Sesatewes CONTROLLED attribute. 

lenanes (EK) ee INITIAL attribute. 

|coaren (EK) peEocerece LIKE attribute. 
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Table EL1. 


Phase EL Routine/Subroutine Directory (cont'd) 


[Routine/Subroutine} = = = Function 1 
SCOATGB (EK) ~—~S~*Procesees DEFINED ATIRIGUIE. OCC 
ienhtee (EK) | Processes ALIGNED attributes. 

ee (EK) iaeeeeee ze UNALIGNED attribute. 

\ eparto (EK) Vepeendes AREA attribute. 

porere (EK) {Processes POS attribute. 

acLse away each item of DECLARE statement. 

‘apeiee (EM) labeaiee factored attributes. 

iene (EM) j|Applies default attributes. 


| 
|CDICEN (EM) 


|. 
|CGENSC (EM) 


| Performs phase initialization and scans chain of DECLARE statements. 
‘cede CEN) {Hashes BCD of identifier. 
pened pee scan routine. 
| eupee eer factor brackets and level numbers. 
ieaeee (EK) {Initializes and passes control to Module EM. 
o_o (EM) petted implicit attributes. 
rein {Performs initialization for each identifier declared. 
DOBTER gc aseaee, 
cae (EM) asia chain of DECLARE statements. 
iegeaag nica correct test mask to be initialized. 
ieee Accuses inheriting of dimensions in sevantares: 
ieNeee Jeoane ahead for next level number. 
Mica ea er eee re ee ere res eat ee ae areal ar io 
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|Constructs dictionary entry. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
J 


Table EP. Phase EP Dictionary Entry III and Call 


|Main Processing| | 


4 

{Examines all labels belonging to an|LBPROC 
jentry type 1, constructing an entry] 

|jtype 2 or 3, if necessary | | | 
waa = $$ nn nn nf en nnn nnn nnn fon nn nn nnn nn neo oe | 
|Follows CALL chain in text making |EPL290 | None | 
{dictionary entries for entry points| | 


| Statement or Operation Type | Routine | Subroutines Used | 
1 Se es IY RSID NI SE PNR Ree OE EA AA SOTERA ET OE RN AOR ETS f 
{Scans for PROCEDURE entries type 1 |ENTRY3 | None | 
|---------—---- -------------------- }--—--~-------- }----------—------------------------ 4 
|Follows chain of ENTRY statement [EPL40 | None | 
jentry type 1 entries froma | | | 
| PROCEDURE entry type 1 . | | | 
~--------------=-----------------}----------—---- ano === == == ------------- +f 

| 

| 


|Examines the first character of an |CDIMAT | None | 
jidentifier and sets a flag | | | 
jindicating the range in which it | | | 
[lies | | | 
}-----—-------—-----------—------—— | aE }-------------~---~----------------- : 
{Applies default rules | CDFLT | None | 
{Given an identifier calculates its \enaae luone } 


joffset in the hash table | | | 


pam aman nn nnn nn nnn fn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn 


{Constructs a dictionary entry | CDICEN | None | 
ma mann nn nn a nf nnn np nnn nnn nn nnn nnn nnn nnn 
|Sets address slot to zero or the | FNDEND | None | 
Jend of the dictionary | | | 
}---------—--------------------—--- Sn en { 
jConstructs list of numbers of known|BLDST2 | None | 
| blocks | | | 
}--—----------------—-------------—- {----~-----—---- $------------—--------------------- { 
{Built in function name | SCANBF | None | 
Oe ee ee A een a ne ee nee et SO oe ee ed 
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Table EP1. 


Phase EP Routine/Subroutine Directory 


[Routine/Subroutine| ~~ + Function —<CSstsiCSTSC‘CS:S 1 
[BLDST2 [Constructs list of numbers of known blocks. { 
rapaeen {Constructs dictionary entry. 
 cprmat {Sets flag for default routine. | 
tees iawea dee default rules. 
Neieat aceite offset in hash table for given BCD. 
iene ieaaee ENTRY chain for PROCEDURE statements. 
er ee entry in entry type 1 chain. 
[EPLAO [Scans ENTRY chain for ENTRY statements type 1. 
| EPL75 peer point from LBPROC routine. ! 
| -PL100 | Processes new entry label. | 
\EPL290 {Scans CALL chain. ! 
‘eeraao [Searches built-in function table for BCD of identifier. 
| EPL360 {Blanks out BCD in text. 
ieeeeon oe the CALL chain. 
ee ieee address slot for label. 
iopbaee | Processes labels of PROCEDURE or ENTRY statements. 
ee |Initialization of phase. 
ronan es later modules as ‘wanted‘' or ‘not wanted’. 
| SCANBE Tenect> for built-in function name. 
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Table EW. Phase EW Dictionary LIKE 

aaa aa aR 90S a a ae | 
| |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used ] 


}---------—------------—----------}--------------- -----------------------------------4 


|Scans LIKE chain | EWBEGN | EWCOPY, EWELDM, EWINCH, EWONDM | 


{Updates hash chain for new entry |EWHSCN ~~ ‘{woneSCSC~C~CS<S;«<S «7S; «SCS 
[Calculates start of structure data |EWART ie 
jfrom start of variable information | | | 
ichaiges Giver Gntty <> nase clewectjaecusn une CS 
[copies dimension table eatry ana jeden [EWNWBK sss 1 
|second file statement | | | 
i a a a a a rae 
Table EW1. Phase EW Routine/Subroutine Directory 

[Routine/Subroutine| = | Function 1 
[ALIGN (EV) Provides) jeorvect alignment Of bess. cleneats in Uikencd secuctire. 1 
|BASED (EV) |Inserts or deletes defined slot, where only one structure is based. | 
— |Scans dictionary to find entry corresponding to BCD in text. 
iaeauen iaseee LIKE chain. | 
ieaciER (eines error entry to base element. | 
iaueone Vewsbes Gictionary entry into scratch storage. ! 
iewacey (EV) eepies initial dictionary entries and associated second file ! 
| {statements, etc. | 
a eons entry into scratch storage with AaGiénaion data removed. 
oe |Tests whether the likened structure is dimensioned. | 
eee |Handles transfer of control to next .phase. | 
a ieeeenade erroneously “likened® major structure. 
ae {Updates hash chain for new entry. ! 
eee "aGesiees entry copy and places it in dictionary. 
lEWNOLE |Tests whether original structure is dimensioned. ! 
laa (EV) jObtains new dictionary block and terminates current one in use. 
\ wan ae entry into scratch storage, inserting dimension information. 
(enter |Processes dimension information in original structure. | 
oe {Tests validity of likened structure. | 
jEw2PN (EV) [copes second file statement and associated dictionary reference. 


to eee -——_—— a a ec ate i ie ee ea ee ve wh ea een a ae es ee ow eee aw a om om om eee om Ce ae om a oe oe ee en oe oe ee ee eee oe ee ee ow 
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Table EY. Phase EY Dictionary ALLOCATE 


a a nt rr ery rr nr rn ee 


i |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
| ~--------—-~-------------—--------}---------------}----------------------------------4 
{Scans text for explicitly | LEMEX | EY14 | 
|pointer-qualified based variables 


{Copies dictionary entries for 
jexplicitly qualified based 
| variables 


EY14 


! 
i 
| 
! 
{ 
| 
t 
! 
t 
{ 
! 
t 
} 
{ 
I 
t 
| 
! 
! 
t 
! 
t 
' 
! 
! 
1 
| 
| 
| 
' 
! 
! 
{ 
! 
! 
nies 


HASH, ATPROC, DICBLD, STRCPY | 


{Second file pointers. Scans 
JALLOCATE statements 


ATPROC, DICBLD, HASH, STRCPY | 


|Completes copied dictionary entry |ATPROC with 
|for an allocated item |second entry 
| |point ATPROD 


| 
| 
ee ee 
| 


| 
| 
I 
! 
! 
! 
! 
! 
| 
! 
! 
! 
] 
t 
| 
! 
! 
| 
| 
! 
! 
! 
! 
{ 
! 
! 
| 
ake 


j|Controls ATPROC and ATPROD routines|STRCPY {| ATPROC, ATPROD 
| for each member of a structure | | 


Da cee are ee as ee ce ee eee ae eee re ee ee ree ener oe we er ne mec hee ae eee ow errno en we eee a ow oS Sa Se ae eee eee ed 


Table EY1. Phase EY Routine/Subroutine Directory 


| Routine/Subroutine| Function | 


a + + + f | 


|ATPROC/ATPROD (EZ) |Complete copied dictionary entry for allocated item by including | 
| jattributes from ALLOCATE and second file statements. | 


| 

DICBLD |Collects attribute given for an identifier and copies its dictionary 
jentry. 
| 


EY16 | Processes ALLOCATE statements. 


I 
EY17 |Processes identifier in ALLOCATE statement. 
E 


Y21 | Processes major structures. 


EMEX {Scans text for explicitly pointer-qualified variables. 


I 
EY14 |Copies dictionary entries for explicitly qualified based variables. 


EMEY |Scans second file, reverses pointers. Scans ALLOCATE statements. 


I 
MOVEST (EZ) {Copies second file statement and associated dictionary entry. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| HASH |Hashes BCD of identifier to obtain its dictionary reference. 
| 
| 
| 
| 
| 
| 
| 
| 
| STRCPY [eontror ATPROC and ATPROD for each member of structure. 
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Table FA. Phase FA Dictionary Context 


(rrr rrr rrr 


Sei et aes a eet i a 4 

|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
}---------—--—----- --=- —- —-- ---- -- == nn =f 2 =n === === =f 
{Scans text |CE30 | CENDTS, CETRAN 
~------------------—--—--------— $---------------}-----------------------------------| 
|Reorders subscripts; makes |CEID | CESCN | 
|dictionary entry for file and event| | | 
| variables | | . | 
fa a nn nn {—-———— fone nnn nn nnn nnn nnn nnn : 
{Identifies keywords | CEKYWD | CEKEND, CEKEOB, CEKEOP, CEKON, | 


| | |CEKPRC, CEKSND | 


won ff 


{Scans dictionary | CESCN |CESTUC, CEYES, CFPDER, CFPDR2, 
| | |CHASH, CE3XX | 


}----------------- --- === =f af 82-2 


|Makes dictionary entry for | CFPDR2 |CDFLT, CDICEN, CDIMAT, CEONCK | 
|variables | | | 
~----+----—— +--+ - - + +--+ +--+ + f+ +--+] 
|Scans dictionary entry for | CECON | CHASH | 
|constants and makes new entry, if | | | 
jnecessary. | | | 
}---------—---- -- - —-- — —- --- =f -- nnn fn nnn nnn nnn nnn nnn nnn nnn 
|Scans PICTURE chain entry and makes|CEPICT | None | 
[new entry, if necessary. | | | 
Mi a a a a a a ag aed Pr) 
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Table FA1. 


tepete 
ricer 
fre 
oe 
1eacon (FB) 
cepa 


| 
|CEID 


| 

ieerke 
VewrstE 
Leaieiin 
leeocte 
oeeene 
lcRnes 
lenede 
ee 
iceReDe 
\eReou 
leaepen 
ieee 
aerer 
irene 
cee 
iceie 
ieewuee 
{CRORCK 
| CEPEDR 
aes (FB) 
\cene 
iegeen 
| CESNCL 


| 
|CESTUC 


tL _ - 
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Phase FA Routine/Subroutine Directory 


aia So a a ng ee 
| Routine/Subroutine| 


Function 
{Determines default attributes for identifier. 
cusenees default dictionary entry for identifier. 
|Determines default scale for identifier. 
{Transfer point for zero or blank. 


|Scans dictionary entry for constants. 


|Subscript prime text marker. 


|Reorders subscripts and makes dictionary entries for files 


| variables. 


-|Transfer point for constant routine. 


{Transfer point for iSUB. 


|Transfer point for CALL to get over chain. 


l 
|Removes SN from DECLARE statements. 


| 
|Processes END keyword. 


{Processes end~-of-block marker. 


|Handles end-of-program marker, or start of second file. 


{Transfer point for keyword. 
{Transfer point for iterative DO. 


| Processes ON keyword. 


{Transfer point for picture format item. 


| 
|Processes PROCEDURE keyword. 


{Moves SN, etc., to output stream. 


|Processes start of second file statement. 


|Identifies keywords. 

eeaneker point for left parenthesis. 

jEnd of text block in output file routine. 
|Makes entry for programmer-named ON condition. 
|Makes dictionary entry for variables. 

iesaae picture chain entry. 

|Transfer point for right parenthesis. 

{Scans dictionary. 

|Handles semicolon. 


|Points at next entry in structure chain. 


De ne ee a ne ee nr rem 


Pepe ee yeas eo 1 


and event 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
\ 
| 
| 
| 
| 
4 


Table FA1. Phase FA Routine/Subroutine Directory (cont'd) 


Wee ee te ee Re TM pee eR ON Ae vg Ce gee a ae ee ae ee eC ee ee ee ee 


Se a ee ae 
| Routine/Subroutine | Function | 
}---~---~-——-----—~ }~~----~----~-------------------------~---------------------------~ -| 
|CETRAN {Translates keyword into transfer instruction. | 

| | 
| CEYES |Compares structure levels. | 
| | | 
|CE2L {Transfer point for second level marker. | 
| 
|CE30 [Controlling Scan of text. | 
| | | 
|CE31 j|Tests for end of block. | 
| | 
| CE32 |Moves one byte to output stream. | 
| | 
| CE300 |Switches to appropriate routine. | 
| | | 
| CE3XX {Compares identifier in text with entry in dictionary. | 
| 
|CFPDER (FB) |Makes dictionary entry for ordinary identifier. | 
| | 
{CFPDR2 (FB) |Makes dictionary for formal parameter. | 
I | 
| CHASH |Hashes identifier. | 
| | | 
|CHASHC |Hashes constant. | 
| | | 
| TEMFA {Initializes phase. | 
Ma a a ae 
Table FE. Phase FE Dictionary BCD to Dictionary Reference 
Eee a a er an DT eR Cee eee ae ae Re eee an ee a a 1 
| |Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
}~--------------------------------—- }--------------- $~~~------------------------- ~------ : 
{Scans text | CE30 {CENDTS, CETRAN | 
on a a a a we a a a a a a a a a a a ee a ee a a a wn we of 
|Scans dictionary | CESCN {|CESTUC, CEYES, CFPDER, CFPDR2, | 
| | {|CHASH, CE3XX | 
i ta er pn ania ene ee a ae ween a ee ee | 
|Checks for array, function, or | CELP | CETNCT . | 
|pseudo-variable if left parenthesis| | | 
jis found | | | 
}--~----------------------—~-------- }---------------}-- ~-------—----- a-~=----=-==----=- { 
{Tests for end of text block | CENDTS |CEKEND, CEKIDO, CEKPRC | 
a AD ep Se AD ED ED SD AEE ERP GD OE CED ED CED ED GE CD SD ED ED REDD SN GED ED wD ED IR a ae ee eS ee ee ee ee ee ee ee ees ee ee ee ee ee ee oe ee ee ee ee a a ee 4 
{Identifies keywords | CEKYWD | CEKEOB, CEKEOP | 
wan = nf nnn nnn nnn nn nf nnn nn nnn nn nnn 
|Makes dictionary entry { None |CDFLT, CDICEN, CDIMAT | 


Cae ce cee ce een cw oe co eter cee rere ee ere ete cnet eee eee cere ee ee een cw en cw ane eee he ae ae ee ee as ee ee eer ren eee ne a ED 
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Table FE1. Phase FE Routine/Subroutine Directory 


ad 


|Routine/Subroutine| Function | 
ane elise ete pai é 
| CDICEN euisvcezes dictionary entry. ! 
ore |Sets flag for default routine. | 
| CEFNCT |Tests validity of function reference in text. 
| CEKEND |Processes END keyword. ! 
cameos |Processes end-of-block marker. 
| CEKEOP |Processes end-of-program marker, or start of second file. | 
| CEKIDO . lpekiaeees iterative DO keyword. 
eRione ipebesees PROCEDURE keyword. 
‘cEReWD hrasnedetes keyword. 
| CELP {Checks for array, function, or pseudo-variable if left parenthesis 
i {is found. | 
coe | reses for end of text block in output file. ! 
leases lecate dictionary. 
leeeeue eee at next entry in structure chain. 
| CETRAN |Translates keyword into transfer instruction 
| CEYES |Compares structure levels. | 
{CE30 {Controlling scan of text. ! 
| CE3XX peers identifier in text with dictionary. entry. 
 oPDICH (FF) Panes dictionary entry. 
ienpeee gece dictionary entry for statement with ordinary identifiers. | 
| CFPDR2 paee dictionary entry for formal parameters. 
pearee [catculates offset in hash table for given BCD. I 
Table FI. Phase FI Dictionary Checking 

fee eS [Main Processing) = sti—(‘iti‘s~sS~S 1 
| Statement or Operation Type | Routine | Subroutines Used | 
lscans text SSSCSC*~<CSs‘“‘“s~“‘s*“‘“‘“‘W SR ”””CCR 
{identifies keywords SSS [CEKEYH |CEKEOB, CEKEOP, CEKIDO, CEKSN | 
(checks GOTO statement references |cEGOTO. eo ee —~ 
lcoaverts eoro'to oun, if necessazy|crcos = ==~CCImone SSCS | 
louse #lie tererencts = **~C eee eee 
ichebke asta 1st ltede ten validigyjcance” = nae’ 


an ae ore a oe ee ere re eee eee a ee we ee eee a on ae enw oo: —_ a sins ca a ee ae ass lan a cam ccs emcees eels a ibe ae Sow ni wi ces me ces gcd ais a SS nwa ah laos ns owen an aoe an aie mimes ae 


Table FI1. 


Phase FI Routine/Subroutine Directory 


Le eS ES NS SD Re SE ED ED EE ED ES TEE ES at Sa eee EES GEES a ee en Se a me OS a en ee ne en Oe SSO! OOO Bee eS ewe wee tetera teste | 
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Directories 


| Routine/Subroutine| Function 

fceomx [Tests value of previous second level marker. 
| etna {Processes function names used as control variables for DO groups. 
Vena leet cane end of iterative DO groups. 

| ceDREF {Tests whether dictionary reference needs to be checked. 
leecy renee data list items for validity. 

oeeree |Checks file references. 

‘eine | Processes function markers. 

leEaoR |Converts GOTO to GOOB, if necessary. 

\epaors {Checks GOTO statement references. 

jeersUB lpiécesuee iSUBs. 

‘ceaGu reuapaceeat pointer over dictionary reference. 

ee | Processes END statements. 

ieekeon ropeseuses end-of-block marker. 

leweeee iieoaeesas end-of-program marker. 

| cexeye {Identifies keywords. 

| CERIDO {Processes iterative DO keyword. 

: cukon | Processes ON statements. 

foe |Processes statement number. 

 CELRCT/CERECT {Process left and right parentheses. 

icacoes renee validity of keywords in the text. 

 cEPREG i peoeesses PROCEDURE and BEGIN statements. 

ona Sesseeaas remote format references. 

i caouer i Seoetaues semicolons. 

|cesrRt Feenerott sng scan of text. 


ewe cemee ceetess ceeees eenten GED que? RED que GEE que RED Gees CUED GED eee ED case eee ae ee cee Gee eee eee mee ees ee eee ee ee ee Oe ee ee ee ee ee ee oe ee eee 
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Table FK. Phase FK Dictionary Attribute 


[Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
a nn rn en ff ne + - - - - - - - | 
{Scans attributes area for SETS | FO1A | None | 
Jj lists | | | 
p-an nnn n ne | [aaa $a -~--—----—- = + === === == - { 
|Scans SETS list | FO2 | None | 
manana nnn nn Hf nnn nn nnn nn nan nn nnn nn nnn nnn nnn nnn nf 
| Processes constants | CONPRO | None | 
}------~------------—-------------—- ---------------} -----------------------------------| 
|Processes identifiers | CESCN {|CESTUC, CE3XX, CHASH | 


| ee ED eS | 


Table FK1. Phase FK Routine/Subroutine Directory 


ee Re en oe me meme 


| Routine/Subroutine | Function 1 
«Se 
| ciioue | Processes unqualified name. | 
leeces messes identifier. 
formar |Finds address of next structure in chain. 
| CE3XX ees current BCD with BCD in hash chain. ! 
\eatan icadenaates offset in hash table for given BCD. 
| CMpERR {Provides termination error action. 
coer |Inserts constant in ordered stack. ! 
Veonees ee constants. ! 
lentes |Releases control. 
| FOERR2 {Diagnoses constant greater than 255. 
nor |Scans attribute tidy-up area. . 
102 {Scans SETS list. 
tean one ree SETS dictionary entry. | 
GETSCR ! Obtains scratch storage | 


| 
ea eee ee meee 
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de ee -  -  -  — J 


Table FO. Phase FO Dictionary ON 


1 
|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
onan nnn nnn nnn nnn nn nnn nf nn nnn nnn nnn wn nnn an anno nnn nn == ===] 
{Scans input text for ON, SIGNAL, | FKMVIT | BEFTRN, CENDTS, QP | 
jand REVERT statements | | | 
| ---- ~~~ === =~ = =~ - == ff == === === === =f 
|Moves second file from input text |F2 |CENDTS, BEFTRN | 
{block to output text block | | | 
|----------------------------------- }--—----------- }--------------------------------—- : 
|Makes dictionary entries for ON- | FKDCEN | LABCD | 
jconditions found in ON, SIGNAL, and| | | 
| REVERT statements | | | 
=== === -—- = === ---- ~~ =f ++ n-ne f 
jExamines BCD of file entries | MVSIG | CENDTS | 
|referenced in ON, SIGNAL, and | | | 
|REVERT statements; scans previous | | | 
fentries for ON conditions | | | 
enna n nnn renner nn nena enn anne anne nnn nmnn anna 
{Processes CHECK and NOCHECK list. |BEFCHL |CENDTS, LABCD | 
|-------------------------—-----—-- }------------- ~-}--------------------------------—- { 
{Creates dictionary entries for | NOMOVE | QP | 
jcondition prefixes | | | 
Table FO1. Phase FO Routine/Subroutine Directory 
re ee ee ee er ae ee er 
| Routine/Subroutine | Function | 
ac cas a i a ee ae is aes | 
| BEFCHL | Processes CHECK and NOCHECK list. | 
| 
| BEFTRN [Replaces statements containing dummy dictionary references by error | 
| |statements, and generates error message. | 
i | 
|CENDTS [Requests a new text block for output. | 
| | 
| FKDCEN |Makes dictionary entries for ON conditions found in ON, SIGNAL, and | 
| | REVERT statements. | 
I . | 
| FKMVIT {Scans input text for ON, SIGNAL, and REVERT statements. | 
| | | 
| FKNOCK | Processes CHECK and NOCHECK lists. | 
| 
| FKPROC {Scans input text for ON, SIGNAL, and REVERT statements. | 
| 
{FP010 (FP) {Chains initial label statements and makes second file dictionary | 
| jentries for each label array initialized in this way. | 
| 
|F2 |Moves second file from input text block to output text block. | 
| 
| LABCD {Creates a dictionary entry for each label constant and each entry | 
| Jlabel mentioned in a CHECK list. | 
| | | 
| MVSIG [Examines BCD of file entries referenced in ON, SIGNAL, and REVERT | 
| jstatements; scans previous entries for ON conditions. { 
| | { 
|NOMOVE (FP) {Creates dictionary entry for condition prefix. | 
1 | 
{Q3 | Processes condition prefixes changed in current block. | 
| | | 
{QP |Determines which condition prefixes require dictionary entries. | 
| | | 
|R8 {Moves statement to output buffer. | 
Yee cies ees ees die tee ee a a eae eae Sam wae 4 
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@Table FQ. Phase FQ Dictionary Picture Processor 
Ge re a eee ate We ee ee a ee 1 
[Main Processing| | 


| 
| Statement or Operation Type Routine | Subroutines Used 


j|Controls scan of PICTURE chain; 
| initializes 


{Picture characters S, $, +, -. |CYSDPM | None | 


mann nna nnn nnn ann nna on nn nnn nn fn nn nn nnn nnn nf 


{Picture character V | CYV | None | 
aa an nn nnn nnn fn nnn nnn nf en ann ne nnn nnd 


{Picture character E. | CYE jcyc21 | 


ee ee 


|Picture character K {CYK jCyc21 | 


aa a nnn nan anf nnn nnn nnn nnn finn nnn nn nnn nnn nnn nnd 


||Picture characters CR, DB | CYCRDB | None | 


}--—------—------------ —---- ----—} ---~-------- = =~ -- { 


|Picture characters 1,2,3 |CYOTT | None | 


ee ee 


[Picture character P {CYP | None | 


+ 
{Picture character 2 jCcYyz | None | 


pom ana nnn nnn nnn nf nnn nn nn nn ann nnn nnn nnn nnn nnn 4 


|Picture character * | CYAST | None | 


| --~---------------------- —-- ------f -- + ~-- -- = f= | 


|Picture character Y | CYY | None | 


manna nnn nn ann nnn ann nn nn nnn rn ren 
{Picture character G |CYG j None | 


|-----—---—---------—-----------—--—- 4--------------- $-—-------------------------—----—- 4 
{Picture characters 6, 7, 8, H | CYSSEH | None | 


t + +---~ 
{Converts integer constants to scale|CYC97 | CYCONV | 
| factor | | | 


A — = === == == == $= $= nf nnn nnn nf nnn nnn nnn nnn 


|Calculates scale factor | CYFNT | None . | 


bon ee ee ee a Le oe ee 
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Table FG1. Phase FQ Routine/Subroutine Directory 


[Routine/Subroutine} ~~~ *Function’s—( sttst—<CSsSSSSSSC‘Cs:S } 
te eee epee eee cary 
rane edenehe tes picture character. 3 
peeee Vateee sud ins scan of PICTURE chain. | 
toseoay Vignes integer constant to scale factor. : 
hevenes peeeeeees picture characters slash (/), comma(,), point (.), and B. 
ee ‘peoceases picture characters CR, DB. 
legen? [Adjusts data to terminate picture before illegal character. | 
levees eonveeee integer constant to scale factor. 
icre peoesiaes picture character E. 
hese | easuatee entry for correct picture. | 
lores |Releases control at end of picture chain. | 
oe eeeeen ase picture character F. 
eerie {Obtains code for next character in picture. 
| CYFNT {Calculates scale factor. ! 
ave i peoeeseed picture character G. 
lege iaecceieea picture character K. | 
Cae Videceeeee picture character 9. ! 
ee Vereee. see picture characters 1,2,3. 
eve ieccaasie picture character P. | 
levsbun iagecenass picture characters S, $, +, -. 
levas i apeaeanes picture characters 6,7. 
| issu aren picture characters 8,H. ! 
\ eae ieceteenas picture character M. ! 
lenaee |Code table for picture characters. ! 
lov |Processes picture character V. | 
ey j peecea wes picture character Y. 
|CYz | Processes picture character Z. | 
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Sag ai ns cep at Aaa cee ses Sas ce Oe oe ee ee ee ce ee ee ee ee ee ee ee ee ee ee ep ee oe ee ee oe ee ee ce i ee es ee oe ee ee es ee ee ee ee ee ~d 


Table FIT. Phase FT Dictionary Scan 

(SFE ee ee eT oe oe Ne eT ee ee ee 1 
|Main Processing] | 

| Statement or Operation Type | Routine | Subroutines Used | 


}--------~-~= == == = === nf nn nnn nn nf nn nnn nn nn nnn nnn nnn nnn] 


{Scans second file Jaci j | None | 
Eason ie aR aan ae aie a fanaa nanan === : 
{Scans dictionary |B1 {None — | 
mann nnn nn fn nn nn nn nf nn nn nn nnn nnn nn nnn nnn nnn 
|Data variables | DATVAR | None | 


}-------------------------—---------4 ---------------}-----------------------------------4 


JEvent or label variables | EVLABV | None | 


|--------------------~----—-------— }--------------- }----------------------------------- i 
|Scans AUTOMATIC chain {G2 | None | 


| -------------------—--------------}---------------} ----------------------------=------4 


{Scans STATIC chain |G3 | None 


| ---------~------------------------- }--------------- }~-----------——--------------------- { 
{Scans CONTROLLED chain |GE1 | None | 


; + } 
{Sets dope vector required bit | Pin | None | 
aan =~ = =H nn a nf nn nnn nnn nnn nap nnn nnn nnn nnn nnn nn nn nnn nf 


| ENTRY type 1 entries JQA4 | None | 


a ED eee anes eee ee ee ee ee ee ee ee ee ee ee er oe ee ee ae es eee Se eS A EY GE ED DC ge Ce ee ee aR os DS ee ee ee ee 4 
JENTRY type 2 entries {QA3 | PROPIC | 


|---------—------------------------ $--------------- }----------------------------------- : 
[ENTRY type 3 entries |QA2 | None | 


fea nn nnn nnn nn nnn nn enn nnn emer mare af 
|ENIRY type 4 entries |Qx | None | 
anna $58 8 nn nnn fon nn nf on nn nnn nnn nnn 


[ENTRY type 5 and 6 entries |QA1 | PROPIC | 


p— =  — n nnnfnnnnnn f na nn nn nn nnnnnnd 


{Constants | CONST | None 


t + + 
| Structures | STRUCT | AJDMRT, MKDMTB, MVTXT 


Cn a a ee a ee ee ee hb en eh nn oe en 


156 


Table FT1. Phase FT Routine/Subroutine Directory 


[Routine/subroutine|—s—=<“—t*~‘i*‘“‘=S*”!CFncticn”s”=*=“‘SOSCS*~‘“‘CS™S™;*@C 
[---------—-------- fan nn nnn nnn nn ncn nnn ne enn : 
JAC1 {Scans second file. | 
{Ac2 [Detects second file statement marker. ! 
| AF3 {Points relevant dictionary entry at statement. | 
ee {Modifies second file statements to initialize dope vectors for base 
{ jelements, rather than for the containinc structures. | 
{Bt jScans dictionary. |! 
ian ieakGetiess dictionary scan. ! 
cogs ipecmiaese constants. 
ore Pe eeeees data variables. 
aren |Processes event or label variables. 
te ieSadauee dimension attributes. 
an {Moves initial label statement to the second file, collecting 
| |together all statements for the same array. | 
haes roeeas CONTROLLED chain. | 
te ieesee eens chain. ! 
a |Secans STATIC chain. 
freee {Creates dimension tables. ! 
pene haseee text blocks. 
| PROPIC J Zxtracts precision data from picture tables. ! 
Gis iaae Sets ‘dope vector required’ bit. ! 
jaa i. Processes ENTRY type 5 and 6 entries. ! 
ee i Processes ENTRY type 3 ceiies, ! 
teas iecclees ENTRY type 2 entries.’ ! 
Hane eerste ENTRY type 1 entries. 
‘ak are ENTRY type 4 entries. 
nwier . Processes structures. 
|TRVECT Ir ransfer vector for appropriate chaining routine. 
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Table FV. Phase FV Dictionary Second File Merge 


a aa a A a a 5 a ne er nae wc Me i eee 1 
|Main Processina| 
| Statement or Operation Type | Routine 
|Reverses second file pointers; 
|scans text for block heading 
|statements; allocates statements 
Jand references to dynamically 
|defined data 
}---~---------------—---------------- 
|Exemines ADF references in second 
|file; completes defined item 
|dictionazy entry 
[Detects dictionary references which|DEFTST 
|refer to dynamically defined data | 
}-----------------------------------} --—------------} -----------------------------------4 
{Examines dictionary references and |DATCPY | F2MOVE, MOVE | 
{moves any associated second file | | | 
{statements to the output string 


— 


Subroutines Used | 


t 
{ 
) 
| 
! 
{ 
\ 
! 
| 
! 
{ 
t 
| 
t 
l 
! 
! 
I 
| 
| 
t 
t 
! 
I 
! 
l 
I 
{ 
! 
I 
! 
| 
! 
\ 
—te 


DATCPY, DEFMOV, DEFTST, F2MOVE, 
MOVE 


DEFCOM 


cafe cm ee ees fe eee ee ee ee ee 

t 
' 
| 
{ 
! 
! 
! 
! 
! 
( 
! 
! 
1 
1 
! 
t 
! 
! 
i 
! 
1 
j 
1 
! 
! 
| 
| 
i 
1 
! 
| 
t 
I 
! 

— 


|Inserts dictionary reference of 
|pointer in associated based 
|variable entry | 


anna naan nanan nn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nn nn nnn nnn nnn nnn 


|Processes adjustable extents on | FVADV | None | 
Jcased arrays | | | 
pono naa - = nnn 5 fo nnn nnn nnn nn nnn nnn nnn nn 
| Processes adjustable lengths on | FVSDV | None | 
jbased strings | | | 
Pio ee Sea ie A a YER gen en ps en aN eT nee ee eee eS r) 
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Table Fv1. 


p----------——- 
| Routine/Subroutine 


Phase FV Routine/Subroutine Directory 


NS pe ee a ee eT a ee ee a Ce ee q 
| Function | 


a= --- == === == =f === ~~ = = = $$ 8 == anna -=- == == +4 


| DATCPY 


DEFCOM 


0 


EFMOV 


o 


DEFTST 


23 


is) 


FV10 


hy 
< 
~ 
oa 


| 
| Fvis 


lays 
euoe 
eer 
ies 
i Suay 
edsay 
| F2MOVE 


| 
| IEMEV 


|Moves second file statements associated with dictionary reference to| 
joutput string. 


{Examines ADE references in second file; completes defined item 
{dictionary entry. 

‘ eaietes text references to dynamically defined data. 

{Detects dictionary references which refer to dynamically defined 
| data. 

‘aewae second file reversing pointers. 

Initializes text scan. 

Scans text. 

Releases control. 

Processes ALLOCATE statements. 

Processes PROCEDURE statements. 


Processes BEGIN statements. 


2) 


‘cans AUTOMATIC chain. 


r 


Inserts D.R. of pointer in associated based variable entry. 
Processes adjustable extents on based array. 

Processes adjustable lengths on based strings. 

Moves second file statement to output string. 

Controlling scan of second file; invokes processing routines. 


Voves text from input string to output string. 


he ee mee ee re ee es ere en ee cee ee ee eS ee SD cee mS mee SS ce SD eee ane SS a ce SS ee eee 


frm ma a ee cee eee eet eee te rem conte ets moe comme 
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Table FX. Phase FX Dictionary Attributes’ and Cross Reference 
arti ae a eg ee ee ee ae ee ee ee ee 


[Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
(Scans STATIC chain for all items |Fxo000.  |rxoui0.~~~S*~C~C<CS 
[Scans PROCEDURE-BEGIN chain —«{{FX0100.~—~S«&YS KOO, FOO, FXOIOS, FXO120. | 
(Scans CONTROLLED chain for ~*‘(rxoi70..~*~“‘«‘NSNOSC*C~C“‘“‘“S*S*S*=‘“‘“‘“<C<CSCSSS 


|non-parameter DECLARED, CONTROLLED | | | 
|dictionary entries | | | 
faa an nnn nn fn nnn nnn nnn nn nnn nnn nn nena nn nnnn nanan ad 
|Scans parameter list from PROCEDURE|FxX0101 | FX0010 | 
Jand ENTRY statements | | | 
aan naan == ap nnn nn nnn nnn nnn nnn nnn nnn nnn 
{Sorts BCD of variables and creates |x0010 | None 

Jentries in scratch text storage | 


| 

| 

~------------------------—---—--—- }--------------- }----------—--------------=--------- { 
{Scans circular chain of ENTRY |¥X0105 | FX0101 | 
jstatement dictionary entries | | | 
Jassociated with a particular | | | 
| PROCEDURE statement | | | 
| --------------------- -- == =f $= nnn nn nn nnn nnn nnn nnn nnn nnn 
{Scans AUTOMATIC chain associated | ®X0120 | FX0010 | 
jwith particular PROCEDURE or BEGIN | | | 
| block | | | 
maaan een nn nnn nn nnn fan nn nnn nn nnn nnn nnd 
{Prints heading line for tables | FXHD | ATTMOV { 
jaccording to options specified | | | 
| --------- = == $= = a nnn nn nn nnn nnn nnn nnn nnn 1 
{Scans sorted chain of identifiers |FfXPRNT | Fx0299 | 
}---------——- ~--~----—--------------- $-------------- -}-----~---------~------------------- J 
|Determines attributes of a given | FX0299 | ATTMOV, FXBCD, FXDCLN, FXEND, { 
jidentifier if the ATR option is | | REFMOV | 
| specified | | | 
}---------—----- == -- 5 2 fn nf nan nn nnn nnn nnn nn nnn 
|Scans the chain of references for a|REFMOV | FXDCLN | 


jgiven identifier (if XREF is | 
|specified) and prints them in 
Jexternal decimal form 


{Converts EBCDIC of particular { 
jattribute to required external form| 
jand moves it to print area | 
mn nn nnn nn np nnn nn nn nnd 
|Prints BCD of identifier having | FXBCD | None | 
|converted it from internal form to | | | 
{external form | | | 
na nn = nn nn nn nn nn nn nn nnn nnn nnn nnn nn nnn nnn nnn nnd 
Converts an internal binary number |FXDCLN | None | 
jto external decimal form and moves | | | 
jit to print buffer | | | 


nanan na ann nnn nn nf nn nnn nnn nnn nd 


ATTMOV 


{Frees all scratch text storage and |FXEND | None . | 
|xreleases control to next phase | | } 
ona cts cae cha abe dren oee enineenn nia nbn eee a Raa aio 
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Table FX1. Phase FX Routine/Subroutine Directory 


ee ee ae ee ee ae ery Pee ete ete es ee a ee ee :] 
| Rout ine/ Subroutine | Function | 
}-----—-------—---- }—------------------------------------------------------------------- { 
-|ATTMOV (FY) {Converts EBCDIC data to required form, moves data to print area. | 
| | 

|FXBCD (FY) |Moves identifier BCD to print area, determines options to be | 
{ | printed. | 
| | 

| FXDCLN (FY) {Converts binary number to external BCD, moves it to print area. | 
| | 

|FXEND (FY) |Frees scratch storage, releases modules, releases control. | 
{ | 

|FXHD (FY) {Prints heading line for table according to options specified. | 
| | | 
|FXPRNT (FY) {Scans sorted chain of identifiers. | 
| | | 
| Fx0000 |Scans STATIC chain. | 
| | 

{| Fx0010 . |Sorts BCD of variables and creates entry in text for each item. | 
| { | 
| FX0030 |Tests for end of STATIC chain. | 
| | 

| FX0100 {Scans PROCEDURE-BEGIN chain. | 
| { | 
{| Fx0101 {Scans parameter list from PROCEDURE and ENTRY statements. | 
| | 

| Fx0105 {Scans circular chain of ENTRY statement dictionary entries | 
| Jassociated with a particular PROCEDURE statement. | 
| | | 
| Fx0120 {Scans AUTOMATIC chain associated with particular PROCEDURE or BEGIN | 
| | block. | 
| | | 
| Fx0170 {Scans CONTROLLED chain for nonparameter DECLARED CONTROLLED | 
| |dictionary entries. | 
{ | | 
| FX0250 {Scans text, making chain of references to each dictioary entry. | 
{ I | 
| FX0299 [Determines attributes of a given identifier if the ATR option is | 
| | specified. | 
{ | | 
{REFMOV (FY) {Moves the references to an identifier to the print buffer and | 
| {prints. | 
5 


sees ards ls eee were a es oe es a ll a as es es et ee es ee ee ee a ee A RD EE ND ates a A GID SE AE EE AR ES OO AO ces A I ED aD a A i cee ce Ne 


eTable Fl. Module F1 Compiler Control 


6 eae A A ce EY SD te OE EN ee ma os ewe TCC -——<——<———— — an ED re Se Oe er ee ee ee eS ee we ee oe eo eae Sw eons 


| |Main Processing| | 


| Function | Routine | Routines Used | 
_--—--—---——--—------—---—-----—--—- }--—----------- }--------------------—-----—------ 
{Checks whether syntax check should |IEMF1 | ZABORT, ZUPL, RLSCTL | 
[terminate compilation | | | 
{Entry to the operating system: | | | 
| None | | { 
becca a ah ea aa anime an eae eet aca bee ia wae ee as a eee ee ee J 
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Chart 04. 
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Pretranslator Logical Phase Flowchart 


*, 
Bi %, OFF OR 726484 8E4 
* *DCES GAe 
.*° FILE YES Sate tess 
‘OR CPEN . #-=-----~> ATE 
*, CORE TANT. -*% : pees" ENE OCES : 
e. an PYrITITITT Titi titTs 
* NC 
keserpecenctuosenesewans: = 
e * e 
C1 8 $4400C20060008068 
-* IsO *&, *I/O MOL GB* 
«*STMNTS AND *. YES goo geeeae ete 
*, 2ND LEVEL  . t--------># * 
*, MARKERS * sivo DRRAMETERS : 
a seeeesstecsseseas 
* NC 
C éSecedcoccenelSenes Seam 
o*. 
Di 2 94999 24849944448 
-* A *,. *MATCH1 GkK* 
«* FONCTION *¢. YES Bo ba b> $~ H- HH HB 
*. REFERENCES .#-------- >* CHECK ‘ 
*.CR OFT=1 .* . faeenraee : 
“eae. oa $694905000 4800088 
* NO 
o#, 
E2 +. 
-* A +. 
NO .* FUNCTION #*. 
Konnnes-nennnn-n=#! REFERENCES |< 
Sigs . 
*, Jf 
* YES 
$40067 20440080888 $9608 30066048 0088 
* Got SMATCH2 GPs 
O~ $- O- 8-4 Be 4 8 Bob anb od Foo oba8 
* PRE-PROCESSCR #-~------— 7% enrcee CHECK 
* FOR GP : PARAMETERS + : 
9299999444459 BESVEDKSEEEESES SHRED 
Fe a EE OE RI OT TE Oe oe eee ee arr A 
« *, 
Gi 4. $4 4986 29949806408% 
o* 2, eenECK en gSt Gus 
* ANY ®. YES jg-  t-t¢-#-4-4- pia 
*, CHECK ietth._--->' PROCEED CHECK 
*. LIST ‘ * ; DITION : 
ar Be Perr TT TIT TTT TTT Ty 
| NO 
o*. 
Hi” **. 049009 29048008088 
* . *STROCTS Fe 
«ASSIGNMENTS 10-25----->s PROCESS” 
*. AS iPecenaeee 
*OR EXPRESS- bd STRUCTURE * 
*. IONS .% * ASSIGNMENTS +*# 
oe PPyTTITIrTitiit ty. 
* KO 
bes scares cSees orale as eo ea aah ies ass 
os 
g1° 8, $9900329004000800 
* ARRAY °*. YES siete eaveasweees 
*: ASSIGNMENTS, - ¢-------->¢ PROCESS = ¢ 
-IONS .*% * ASSIGNMENTS * 
*. 58 $$99609 4000089440 
* WO 
e |. 
Ki °*, 09490K 240000000000 
. s, *ISUBS BP* 
Pid ANY YES Gm $a Go Hm Ho Ho Ho HH 
* + J508 INED | stowannn nade PROCESS ITEMS : 
“e. - * ustne IeUBS 3 
*. 48 $4 909690080 986008 
be Pe TTT 
[_ *05 * #05 
>* Al * ->* Ai * 
e * 
eens e000 


162 


Chart GA. Phase GA Overall Logic Diagram 
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Chart GB. Phase GB Overall Logic Diagram 
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Chart GK. Phase GK Overall Logic Diagram 
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Table GA. Phase GA DCLCB Generation 


{Main Processing] | 


| Statement or Operation Type | Routine | Subroutines Used | 

------------------—--- —-------- —} ------------- +f -— ~---- == === 
{Scans STATIC chain | IL0100 | IL0110, IL0120 | 
POLED NSUTEPAIgunN-taa=p-e=aoaEpRISUE SRE TEP" SERRE $-------------- ~----—----------------------------| 
{Generates DECLARE control block | 1L0110 |CHKATT, IHEENV | 
jentry | | | 
~---~--~-—--—--------------------} -------- - +f --- --  - 
HCEnerSves OPEN control block entry |IL0120 | CHKATT | 


Cn ae nee a ee ee ee ee ee a eee ae ee ee a er ae ee ee ane ane ane eaedle can emer ee Oe a ae a cae oe ome ee ae ea eo oe nee ae oe ae ae ee ee eee ee nd 


Table GA1. Phase GA Routine/Subroutine Directory 


Le EP CD SD SS AE ES SS ND ND ND ND SD ES FS A SS SS NS SEND SD SY STS aS SES SND ES SEP OES GS GED GED SED OS GD GET EUETED GED Ga CUS EE GD aD EES a CS ee ee ee ee Se ee 


| Routine/Subroutine| Function | 
(\cauray. AGieck® seeedbates andvorestes Goutzclwocae! = C=C 
oe ienecne environment options, and inserts them into DECLARE control |! 
| | blocks. | 
{IL0000 jEntry point from compiler control. ! 
| 7.0100 oe STATIC chain. | 
ietb1i6 Vichsvates DECLARE control block entry. 
{IL0114 {Test point for environment entry. | 
{1L0115 |Return point from environment processing. ! 
| IL0117 ‘ oteeeuses file attributes entry. | 
angie ‘apenas point of SYSPRINT file found. 
| rn040 cheeses OPEN control block entry. 
paroeee |Reteases control. 
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Table GB. Phase GB Pretranslator I/O Modification 


|Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
}-------------—---------------------}---------------} -------------=--------- === == === 
{Removes all second level markers | Throughout ' | None | 
| | phase i | 
a ae ee oe ep Soe cee oe ee ae we ee ee > ee ee en a re oe ame SE Ach sce ENE tee tae Ae EP Tes ee Ee A DO I SE RE Gee Sy ee gee SD Om “NE ENF I OED eee ERT Ha ye OEE TE ee A ee ce ay ee ee er ce ce ee 4 
jReorders options to put EDIT, DATA |A8 {|SCNS, SCAN2 | 


jor LIST last | 


4 
|Moves DO specifications to precede |SCAN2 
jrelevant list in data lists, adds | 

[END statements | | | 


}------------~----------------------}---------------} -----------------------------------+4 


JExpands iteration factors in format] FORLST | None | 
[lists | I | 
aa === === -------- 2-2 -- === +--+ f= === == == 2 === - === ----- = ---=------------4 
|Checks for use of COBOL files in {A4 | LOCATE, READ, WRITE, DELETE, MAP, | 
{READ, WRITE, and LOCATE Statements | | COPY, STSCAN | 
es clo en eee nuoem ace emewol KG pee ee ee ee tree Diese eee eee eee eee J 
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Table GB1. Phase GA Routine/Subroutine Directory 


UD CED OD GED a ee ED ae GD GER mee ee GS OD eee eee ee Oe ee oe ee A A SD A ED A Se LAD Si ED Se EN SE AO NS SED SNS SNE AOD ND OES ENS ED AAO ES EES SEED 


{Routine/Subroutine| Function | 
~------~---------}} ~~ ---- ~~ ---- += - =~ - = o-oo nnn nnn nnn == 

| AFORMT {Processes FORMAT statements. | 
| | 

[A4 {Checks for use of COBOL files in READ, WRITE, and LOCATE statements. | 
| 

| A6 |Scans source text for GET and PUT statements. | 
| | 

{A8 |re-orders options to put EDIT, DATA, or LIST last. | 
| | 

{A21 |Scans GET or PUT statement for data specification. | 
| | | 
{COPY (GC) {Copies a structure and places the copy on the COBOL chain. Sets up | 
{text skeletons. | 

| | 

DELETE (GC) {Removes an offending I/O statement and inserts an error statement in| 
{the output text. | 

. | 

FORLST {Expands iteration factors in format lists. | 
. | 

F2 |Creates and buys integer temporary. | 
| . | 

F5 {Scans and outputs format item. | 
: { { 

FSA {Sells temporary. | 
| 

F6 |Tests for end of format list. | 
| 

| F6A {Tests for end of format specification. | 
F6B [Outputs end of format specification. | 
| 

F7 {Scans format list. | 
| 

LAB17B | Processes format list in GET or PUT statement. | 
| 

LLDOIT {Moves DO specifications to precede relevant list in data lists, adds| 
|END statements. | 

| | 

LOCATE (GC) |Checks for the use of a COBOL file, and puts out a warning | 
| diagnostic. | 

| | 

MAP (GC) |Compares the PL/I and COBOL and PACKED(NONSTRING) mappings of a | 
jstructure. | 

| 

MKROOM | Provides space in a statement in new source file. | 
| 

MR {Initializes text blocks and pointers, and obtains scratch ‘storage. | 
{ | 

READ (GC) [If a READ IGNORE is encountered, no action is taken. If a READ SET | 
{is encountered, a warning diagnostic is given. If a READ INTO for a| 

{structure is encountered, PL/I and COBOL mappings are compared. | 

| | 

SCAN2 {Scans option list for end of option or statement, expands DO | 
|specifications, and changes certain function markers into | 

|pseudo-variable markers. | 

{ | 

SCNS {Scans option list for end of option or statement. | 
; { | 

STSCAN (GC) {Stores the dictionary reference of the file and the INTO/FROM | 
|variable, and sets flags. | 

| : 

{WRITE (GC) |For structures, the PL/I and COBOL mappings are compared. | 
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Table GK. Phase GK Pretranslator Parameter Matching 1 


|Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
wn nan nn nnn nf nnn nnn nnn nn nn nn nnn nnn nnn nnn nnn nnn nnn 
{Scans source text for function | BASCAN |CPSTMT, CRSTMT | 
{markers | | | 
pra nnn nnn nnn nnn nnn nnn nnn nnn fn nnn nnn nnn nnn nnn nnn nnn nnn nnn anna 
|Processes function, puts out | BAFM | SCANRP | 
|reference and initial code bytes | | | 
}~----------------------------------}---------------}-----------------------------------{ 
|Processes arguments | BALOOP |ADDTGT, SCNCRP | 
{Checks numbers of arguments {|ARGNOQ | | None ? 


Table GKi. Phase GK Routine/Subroutine Directory 


| Routine/Subroutine | Function | 
‘ice ae Beeaeo cue eee Ce 
JARGNOQ {Checks number of statements. 
iaaens eta for STOP marker. 
Ory: {Outputs function and first bytes of argument list. 
aADREN iaeake for end of argument list. ! 
lair |Processes function, puts out reference and initial code bytes. 
leagen |Locates SETS list and parameter list for function. 
ieayeoE ievshenada arguments. | 
preee |Tests whether argument list is present. 
lations |Accesses next argument in list. 
beaaous {Sets STOP marker to scan argument. 
1aKogs jeiaaines pseudo-variable. 
ieanece {Tests for nested function reference. 
BARGE fouepaee warning message. | 
fuNeeat {Scans source text for function markers. ! 
oe leatoate argument. 
lepers ‘aide closing bytes of a statement to output text. 
| CRSTMT jAdds first bytes of a statement to output text. | 
ee {Scans argument list. 
SCNCRP |Scans argument. 


\ 
boa eet ear 
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Table GO. Phase GO Preprocessor Parameter Matching 2 

a ree eee Ne ee a ge ea ee ee ee 1 
|Main Processing] | 

| Statement or Operation Type | Routine | Subroutines Used | 


: + 
{Initialization and scratch core | 
Jutilization for Parameter Matching | 
| 
1 


Table GO1. Phase GO Routine/Subroutine Directory 
ee et a Sg et ee eee a he eee eee nn ee en a eens eee ene =] 
| Routine/Subroutine | Function | 
~---------—-------}-------------- +--+ ---- - +--+ -- = += $= === $+ = = - +--+ = = = === =| 
| PMATCH |General initialization and scratch core utilization for Parameter | 
| . [Matching 2. | 
I | 
| POLYMV {Moves the routines POLY1, POLY2, POLY3, POLY4 and POLYS into scratch] 
| |storage (see Table GP). | 
Cleese a ee ese ee be ea ae eee ene el eee ee CS oe mee J 
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Table GP. Phase GP Pretranslator Parameter Matching 2 


(SRE Wen a ee a ee ee ae 1 

|Main Processing] | 
| Statement or Operation Type | Routine |. Subroutines Used | 
onan a nnn nnn nn ar nnn nnn nn finn nnn nnn ann nnn nnn nn nen nnn ccna naan mann nnannd 
|Scans text for procedure and |BS1 [|ADDTT, STKINF, UNSTCK | 


{function calls . _ | | { 


0 ae a ae ae ee ee ee a ae ee a ee ee ee wr nn = - = = - - = | 


{Examines argument lists for |Bs4 | | EXSCAN, M1, M4, M16, SCANFR | 
| expressions | ese | : . | 
|Creates temporaries for scalar [M16 -|ADDTT, COPYTP, MKDCEN, SETBUY | | 
jexpressions and constants | — | a | 
fram nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nan nn nn nn nn nn nn nnn nnn nanan 
|Creates temporaries for array | E2 | ADDTT, CHCKB1, COPYTP, MKDCEN, | 
jexpressions | | SETBUY | 
}-----------------------------------}--—----------} --- ------------ === === == === == == === 
|Creates temporaries for partially {E3 | ADDTT, CHCKB4Y, COPYTP, MKDCEN, | 
jsubscripted array expressions | | SETBUY | 
Sete eee ee a an nn nh en ee ener enn ene esecence= 
{Creates special temporaries for | EX16 |ADDTT, BS2, CHCKB4, CHECKT, COPYT1, | 
|partially subscripted arrays | | MKDCEN, STKINF, UNSTCK, 211, | 
oo | |SETBUY, SETMT { 
ASUS nRENEy OEP SuREDUUTES UNEP ETSI haere ne fn rn en enn nein { 
|Checks single arguments (except [M4 | CHECKT, M16 | 
|structures) with parameter | | | 
{descriptions ] | | 
Oe ED EEF ate ae ae a ee ae ee ee ee ee ee ee ee ee ee ee ee eer eee 2 ae ee a Ee FE aa Ge eee RE I art ae OE tee ce SRS II a aR a Sem eh 4 
{Checks single structure arguments |M5 | CHECKS, CSTTMP | 
| ----- ~~ nnn nnn nnn nn fn nnn nnn nf cn nnn nnn nnn nner amen nrccr ann nenen4 
{Creates temporaries for structure |M21 . |CSTMP2, MKDCEN, CHCKB4Y, SETMT, | 
| expressions | | ADDTT | 
|Creates temporaries for partially |222 ‘i ADDTT . . | 


|subscripted structure | | . | 
~------~ --+-------- ---- -- ++ -- - --- -— | -- - - - - - - -- - - - - = -- $= $+ = = 
ieomsace the two arguments of the |{POLY1, POLY2, |BS2 
{POLY function and create |POLY3, POLY4, } 
|temporaries if the arguments are { POLY5 | 
[not both floating and do not have |. | 
{the same scale and precision | | 


eta eet a eee 


‘|Creates special dictionary entries |M37 | None | 
|for generic entry labels used as | | | 
nae cuTente | | | 
beceneee tee eee ee ee Eee eno nara to a a ac a hs cc Co 
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Table GP1. 


Phase GP Routine/Subroutine Directory 


| 
|CHCKB1 (GR) 


CHCKB2 (GR) 


HCKB3 (GR) 


Q 


2) 


HCKB4 (GR) 


HCKS1 (GR) 


HECKB (GR) 


Qo Qn 9 


ee] 


ECKS (GR) 


HECKT (GR) 


OPYTP (GR) 


QoQ 9 4 


OPYT1 (GR) 


JEXSCAN (GQ) 


JEX16 (GQ) 
JEX36 (GQ) 
Ww (GQ) 

| es (GQ) 
aces (GQ) 
ia (GQ) 

a2 (GQ) 

a (GQ) 

MS (GQ) 

1e (GQ) 


| 
[M10 (GQ) 


| 
|CSTTMP/CSTMP2 (GQ) |Create temporary structure dictionary entries. 


| 
|Compares the bounds of argument and parameter arrays, and creates 
{new dimension tables for temporary arrays. 


| 

{Compares the bounds of argument and parameter arrays where the 
jargument is partially subscripted, and creates new dimension tables 
| for temporary arrays. 


{Creates a new dimension table from a parameter description. 


{ 
jCreates new dimension tables for partially subscripted array and 
jstructures. 


{Compares the structuring of argument and parameter structures. 


|Compares the bounds of argument and parameter arrays. 


| 
{Compares structuring and data types of argument and parameter 
| structures. . 


|Compares data types of arguments and parameters. 


{Creates a temporary dictionary entry from a parameter description. 


|Creates a temporary dictionary entry for a partially subscripted 
jarray from a parameter description. 


|Scans expressions for arrays and structures. 

|Creates temporary arrays for partially subscripted array arguments. 
|Creates a chameleon dictionary entry. 

{Creates temporaries for array expressions. 

|Creates temporaries for partially subscripted array expressions. 
|Makes dictionary entries. 

{Examines argument expressions. 

|Examines single arguments with parameter descriptions. 

ieanoeeee single arguments with parameter descriptions. 

|Examines structure arguments. 


jTests for structure parameter. 


{Processes subscripted variable argument. 


| Routine/Subroutine| Function 

jaDorE Gay nade Reet co outpue bicckh’ Ce 
‘sak seer input text. 

lies haeans input text. 

lee ee argument lists for expressions. 

(Bei |End-of-program routine. 

| 3833 {Tests for constant argument. 


hetetec eee ate eh ee i eee ans Wee a a a See eed 


Chapter 3: Flowcharts, Tables, and Routine Directories 177 


Table GP1. Phase GP Routine/Subroutine Directory (cont‘d) 


|Routine/Subroutine| Function | 
[M12 (GQ) |Creates a warning message. | 
| { | 
{M13 (GQ) jGets BUY text. | 
| 

{M14 (GQ) {Processes scalar argument. | 
| | 
{M16 (GQ) {Creates temporaries for scalar expressions and constants. | 
| | 
(M21 (GQ) |Creates temporaries for structure expressions. | 
| 

{M22 (GQ) {Processes data item parameter. | 
| \ | 
[M23 (GQ) |Processes label parameter. | 
{ | 
[M24 (GQ) jCreates a structure temporary. | 
| | 

{M37 (GQ) [Creates dictionary entries for generic entry labels which are | 
{ | arguments. | 
| | | 
{M41 (GQ) |Error routine. | 
| | 

(M44 (GQ). | Processes dimensioned scalar argument. | 
| | 

|POLY1, POLY2, |Check the arguments to the POLY function and generate code to buy | 
|POLY3, POLY4, |temporaries, if the arguments are not both floating and do not have | 
|POLYS (all in GO) |the same scale and precision. | 
| | 

| SCANFR |Scans for matching parentheses. | 
| 

|SETBUY (GQ) jInserts skeletons to buy temporaries in the output text. | 
| 

|SETMT (GR) {Sets temporary dictionary references in MTF compiler functions for | 
{ jarcay and structure bounds. . | 
| 

| STKINF |Stacks information on encountering nested functions. | 
| 

| TESTC |Tests for constant argument. | 
| 

| UNSTCK . [Unstacks information. | 
| 

}Z11 (GR) {Generates text to set up the dope vectors of partially subscripted | 
{ |array temporaries. | 
{ { | 
{Z22 (GR) {Generates text to assign the structure subscripts of partially | 
|: jsubscripted structures to temporaries, and then to set up the dope | 
| jvector for the partially subscripted structure temporary. | 
Pewee ee eee ke eee ee eee een eee ee eee eee eee eed 
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Table GU. Phase GU Pretranslator Check List 


|Main Processing| { 
| Statement or Operation Type | Routine | Subroutines Used | 
|-----------------------------------}---------------} -----------------------------------4 
|Scans statement; checks if | BSCAN |CALL, LIST, MOVE, SUOPQ | 
|preceding SIGNAL statement is | | | 
|needed | | | 
|-----~-- ---- ~~ ---- == -- -- == -- $= $= - fo 5 nn nn nnn nnn nnn nn nn nnn nnn ne nnn == === =f 
|Scans statements; checks if | ASCAN | None | 
{following SIGNAL statement is | | | 
|needed | | | 


wana nnn ann nnn nnn nnn nn inn nnn nnn nnn nnn nn ncn nnn nnn nnn nnn nnn crea ncaa 
|Provides a SIGNAL CHECK statement |CALL | GENTST | 
}----------------------------- ------}} ---------- -- $=} 2-2 2-2-2 == =f 


{Searches list for checked items | SUOPOQ {CALL, LIST | 


ac a sc a a ae as ee oo ee a a ce ee ee ee oe we ee hom oe ee ee ee ee co we eh, ee ae ee we we we ew we ee ee wd 
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pasha GU1. 


| ABGNDO 
Pe 
re 
lapenie 
Vase 


| 
| ASPECL 


| 
| ASTMT 


| 
|ATESTY 


| 
|ATEST5 
| 
JATST3 


| 
| BENTON 


| 
| BPC 


| 
| BSCAN 


| 
|BSTMT 


| 
| BTEST3 
| 
| BTESTG 


| 
| BVARNO 


| 
|CALL (GV) 


eee 
icherex 
re 
egbeae 
ene 


| 
|GENTST 


(GV) 
(GV) 
(GV) 
(GV) 


(GV) 


| 
[LIST (GV) 


| 
| MOVE 


| 
| SUOPQ (GV) 
wee on an enn a een a whew ane eames an eae Bo a eee oe eee Cee ee eee eee ee ee See ed 
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Phase GU haa datiegast el eames Directory 


|Sets IF-switch for THEN or ELSE clause. 
| 


|Signals checked items in argument list. 


|Tests statement identifier and takes action if necessary. 


|Scans statements; checks if following SIGNAL statement is required. 


| Examines statement dictionary entry. 


{Examines statement dictionary entry which is not a label. 


| Housekeeping for end of statement. 


{Tests for argument list. 


| 
{Tests for THEN. 


|Tests for end of statement. 


[Test whether argument list contains checked item. 


| Processes 


{Scans statement; checks if preceding SIGNAL statement is required. 


“possible check" statement. 


|Tests whether SIGNAL statement may be needed after statement output. 


{Tests for end of statement. 

|Tests for argument list. 

|Tests for END statement. 

aaketee SIGNAL statement for checked item. 

{Tests whether SIGNAL precedes or follows statement responsible. 
JExit from subroutine CALL. 

{Tests whether DO statement must be output. 

aesenees overwritten statement after NO statement. 
iGaeuuke SIGNAL statement. 

ree space in output text block. 

|Updates and searches list of currently checked items. 
{Moves text from source to output. 


{Searches list for checked items. 


ee eee ee eer ee ee ee me ces me ee ee ne ce a ne ee ee ae ee Se eee ee eS ee ce eS cee ne eee re ee Se ee ee mee cee ee ee ee eee eee mle ed 


Tabie HF. Phase HF Pretranslator Structure Assiqnment 


Ee eee ee ee ee a ee ee ee eae ae et eS ee ee 
| [Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
Jona nnn nn nnn nnn nnn nnn nnn nn pana fami n nnn anna nnn nnn non 5= === === = =~ == { 

_|{Seans text for structure assignment | MR | BYNAME, GENTST, LSTSCN, MOVE, 
{|Statements, regions of nested | |NSTSCN, STRASS, STREXP, STRURE 


|statements, output list | | 

jexpressions, and structure | | 

{references in input lists { | 

| --------~------ --------------------}---------------} ----------------------------------- 
JExpands structure assignments and |BYNAME, STRASS,|DVCON, GENTST, LSTSCN, MOVE, 
jexpressions into a set of scalar {STREXP, STRURE |NSTSCN, SBGN 

Jassignments or expressions 
{corresponding to the base elements | 
jof the structure operands. Where | 
{the base elements are arrays, the | 
|corresponding component expressions | 
jor assignments are surrounded by | 
jappropriately iterating DO groups | 
2 ae re ow am on am am epee en an eren en an em an aes anes aoe wo en nn fe + - 1 re ow ae ae an et we a ee eee ep em ae re oe ee ee eve om ae a oe we ee oe ee 
|Scans regions of nested statements |NSTSCN | MOVE, NSTSCN, STRASS 

{for structure assignments | | 


fe oe ae meee eee me em eee 


{Determines space availability in an|GENTST | MOVE 

joutput text block | | 

a= 2 ---- === === == === $= $= nn +f oon === 
{Scans function argument and | LSTSCN | MOVE, NSTSCN | 
{subscript lists | | | 


wwe eee calle cere ele cemeee sem cele eens mee ere ree eee eee eee ee eee ecb nee ewe ee ee coe 


+ + 

|Constructs DO statements and checks|DVCON | 

[bound equivalence | | | 
+ 
| 
| 


4 
{Constructs subscript lists for | SBGN 
|references to dimensioned structure] . 
| base elerents | | | 


Lw———.— ~~ eb ee Le ee ee I 
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Table HF1. 


Phase HF Routine/Subroutine Directory 


(eres se SSeS 28 Se HT EE GAD SRS OAS A SES GD ESS ED SS DD SD OS ED Se SD EE SE SS Se On 8 8 8 OS OF Oe Oe OS O88 8S OSS SSS SOS SOOO OCOS O Wee 1 


_ [Routine/Subroutine| 


|BYNAME (HG) 
on (HG) 
| evade (HG) 
re (HG) 
eae (HG) 
\ceirer 
trees 
ieerech 
{us2a 

\us23 

| MOVE 


i 
|MR 
{ 


eer 
ane 
ren 
pare (HG) 
fos (HG) 
taxeD (HG) 
folnes (HG) 
eat (HG) 
520 (HG) 
re (HG) 
| sa36 (HG) 
| eaT3 (HG) 
beads (HG) 


| 
| SBGN 


| 
{STRASS (HG) 


| 
|STREXP (HG) 


| 
| STRURE (HG) 
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Function 

|Expands BYNAME structure assignments. 

|Searches for matching BCDs down to base elements. 
{Returns to start of current output assignment statement. 
meee for matching BCDs. 

jConstructs DO statements, checks bound equivalence. 
[Determines space in output text block. 

nese for GET statement. 

{Scans subscript arguments and subscript lists. 

|Tests for structure item in data specification. 

{Tests for data-directed data specification. 

jAdds text to output string. 

|Scans text for structure assignment statements, nested statements, 


joutput list expressions, and structure references in input lists. 


{Tests for BY NAME assignment statement. 


|Scans source text for structures. 

pee regions of nested statements for structure assignments. 
jBuilds up stack to show pattern of structure. 

|Tests whether END statements need to be output. 
ielatnes dictionary reference found. 

|Scans structure expression or assignment. 

|Tests whether item matches the stack pattern. 

{Tests for start of structure expression. 

{Outputs base element and replaces it in source text. 
ireses for BY NAME assignment statement. 

{Outputs END statements. 

Saal scan pointer to start of expression/assignment. 


{Constructs subscript lists for references to dimensioned structure 
| base elements. 


i 
j|Expands structure assignments into DO loops. 
|Expands structure expressions. 


{Expands structure references. 


Table HK. Pretranslator Array Assignment 


l {Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
}~---------------------- —-------- --}}---- + -- $= oon $$$ = one e-n----=f 
|Scans text for array and scalar | MR | None | 
jassignment statements | | | 
}~------------—--------------------- }------- -------- }----------------------------------- : 
jScans text for nested array and | MR | NESTAT | 
|scalar assignment statements | | | 
----------------------------------- }on-------------} -----------------------------------4 
|Scans text for array expressions in|MR | ARRASS, LSTSCN | 
{I/O lists in GET and PUT statements] | | 
et ee nm a ne en fe en ee = SS EF GR ee ee OEE em et ee ee ee ee eee ee ee ee ee ee 
j|Expands arrays into DO loops and |ARRASS |FRETMP, MDE, OPTST, SLGCH, SUBSKP | 
|scalar assignments; checks | | | 
{dimensions and bounds | | | 
Table HK1. Phase HK Routine/Subroutine Directory 
a ee ee eee et ee nee a ee ee ee ee 
| Routine/Subroutine| Function | 
on an ape EE a Pa ee 6 ewer a> Gea a 22 ae a a rn rn + - - | 
|AADOP (HL) |Examines leftmost operand. | 
| . | 
{AAMULA (HL) {Tests for multiple assignment. | 
| | 
{AA3 (CHL) {Checks pseudo-variables. 
{ | 
{AETRT (HL) j|Scans array expression. : 
| | | 
JARRASS (HL) |Expands arrays into DO loops and scalar assignments; checks | 
| {dimensions and bounds. | 
| | 
JARREXP (HL) {Generates DO loops and subscripts for array references. | 
| | | 
JARRIN (HL) |Entry point for array expressions in input lists. | 
| | 
|ARROUT (HL) |Entry point for array expressions in output lists. | 
| | 
| FRETMP {Generates a SELL statement for temporaries bought in the current | 
| { statement. | 
{ | 
| LSTSCN |Scans I/O lists for possible array expressions. | 
| | 
| MDE {Makes a temporary dictionary entry. 
| i : | 
[MR |Scans text for array and scalar assignment statements, for nested | 
| |array and scalar assignment statements, and for array expressions in| 
i |GET and PUT statements. | 
| | 
| MREOP |Tests for end of text. | 
| | | 
|MRTRT {Scans text. | 
| | | 
| NESTAT |Scans nested statements. | 
| | | 
| OPTST {Tests any given operand. | 
( | 
{| SLGCH {Generates and checks subscript lists. | 
| | 
| SLMCG {Inserts subscripts in expanded array position. | 
| | 
| SUBSKP {Skips a subscript or subscript list. | 
i so ren peal amend 
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Table HP. Phase HP Pretranslator iSub Defining 


| Statement or Operation Type | Routine | Subroutines Used 

fro rn rrr rr rrr rrr rn _— on ae Oe ee BP ae —_— oe ee ere ee oe a a ee ee oe ee ee oe 
|Scans source text for references | MASCAN | MOVE 

|defined by iSUB | | 
}-----~-----------------------------}---------------}----------------------------------- 
|Processes references defined by | DEFSUB |GENTST, MOVE, SULIST, SUMOVE 

| iSUB | | 

een SP ee ee ee ee ee ee ee eS Se Ff SS Se ee a see eeSs= + SS ne Seen ewe eee 
{Scans subscripts | SUMOVE | None 


Table HP1. 


|Main Processing| 


| (in SULIST) l 


Phase HP Routine/Subroutine Directory 


| 
| 
J 
t 
| 
| 


| 
| 
r 
| 
| 
J 


|Routine/Subroutine | 


Function 


aa nnn nnn nnn nnn nf ann nnn nn nn nnn nnn nnn nnn nnn nan nnn nnn nnn nnn nnn nnn ned 


| DEDONE 
eee 
fpERsUE 
ipEeand 
are 
Pewee 
LpEaCUR 
tian 
Seren 
eae 
ee 

TMRBCaN 
INOUE 

‘autres 
aioe 
eee 


| 
| SUSUBS 
L 
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jResets pointers to scan first subscript list. 


{Creates and buys temporary. 


[Processes references defined by iSUB. 

{Tests for end of second subscript list. 

{Outputs first-list subscript and tests for end of list. 

jTests whether dictionary reference is constant or integer variable. 


|Stacks parameters for recursive entry to DEFSUB. 


| 
{Returns to MASCAN or SUSCAN. 


|Tests whether second-list subscript is simple dictionary reference. 
|Checks space in output text block. 


{Initializes text blocks and pointers, gets scratch storage. 


{Scans source text for references defined by iSUB. 


|Moves text from source to output. 


|Scans subscript lists. 


{Scans subscripts. 


{Scans subscript. 


{Replaces iSUB by corresponding subscript or temporary. 
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Chart IM. Phase IM Overall Logic Diagram 
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Chart IT. Phase IT. Overall Logic Diagram 
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Chart IX. Phase IX Overall Logic Diagram 
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Chart JD. Phase JD Overall Logic Diagram 
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Tanle IA. Phase IA Translator Stacker 
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Tabie IG. Phase IG Translator Pre-Generic 
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|Scans text for BUY agqregate |GS1 {FR, BR, TRF1, GS12 ; 
jargument dummies, end-of-block, and| | | 
|end-of-program triples | | | 


cr 


|Obtains next text block |GS12 | None | 
~----------------------------------}--------------- }-----------------------------------4 
|Transfers text to output block {TRF1 | None | 
ieee ee en el Oe Se eS a a eae aaa ee 4 
|Transfers text skeletons to output |TRF2 |GS1, TRF1 | 
a a sg os os cassia et aca et reas oie ever eed ae ees a ee a Se 
|Stacks and unstacks information on |FR, FRP | None | 
Jencountering function and function | | | 
{triples | | | 
~---------------------------------- }---------------}-----------~-----------------------4 
jInserts assignment statement for | BR {GS1, TRF2 | 
laggeegate argument dummies | | | 
Sitters ieee aan eee ee ie ee ee a ee hee eke ena eee eee eed 
Table IG1. Phase IG Routine/Subroutine Directory 
ee ag eee Oe gtr eg eae ee eg ee eg ee ey reed 
|Routine/Subroutine | Function | 
}---------—------- fan nnn nn aren nnn nn rere ~------=---------- : 
| BR jInserts assignment statements for aggregate argument dummies. | 
| | | 
|BR1 {Transfers point for IGNORE triple. | 
| 
|BR2 |Inserts assignment into text. | 
| | 
| BR3 |Makes new dictionary entry for temporaries. | 
| | 
| BR4 {Processes second BUY. | 
| | 
|FR, FRP {Stack and unstack information on encountering function and function’ | 
| |triples. | 
{ | 
{GS1 {Scans text for BUY aggregate argument dummies, end-of-block, | 
| jend-of-program triples. | 
| | | 
|GS12 {Chains to next text block on encountering an end of block marker. | 
| { | 
{TRF1 |Transfers text to the output block. | 
| { | 
{TRF2 [Transfers text skeletons to the output block. | 
OR Serene eamenene ee ener Ba ee as Sa pleases ence i a a a ak Ss a Sa el ee a J 
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® Table IK. Phase IK Translator Pre-Generic 
Se aa © ep ee ey ee ae ee ee Ce ete ee te On ee eS ee a ee 
| |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
j|Initializes phase and obtains text TEeTeR iene : 
jblock storage for routine GNEOP | | | 
| (called by main generic phase), for| | 
{translate table SCTRT used by the | | 
jexpression analyser and for nested | - | 
jfunction stack | | 


: + 
{Moves routine GNEOP, and table | MOVETT 
{SCTRT into text block storage | | 
|Loads Phase IL and transfers | LOADIL | None | 
{control to it [. aos | | 


be ee a ee ew ae Le he ee eed 


@ Table IL. Phase IL Translator Pre-Generic 


CS Sr ee ee eR ee en eee eee eee Sy 
| [Main Processing| . | 
| Statement or Operation Type | Routine | Subroutines Used | 
pon nn nn nnn nn nn nf nnn nnn nnn nnn fn nnn nn nnn nn nn : 
{Initializes phase, qets scratch | BEGIL | None . | 


{storage and sets pointer to | | | 
[function table { ’ | | 
}-----~--~--~---=-=- —-~------- == 2 = fn nnn nnn nf 
{Moves function table into scratch |BASROU | None | 
{storage and sets pointer to nested | 
|function stack area 


| 
| | 

--~-----~-----------—--------------— $---------------}---------------------------=----—-4 
|Loads modules IM and IN and sets | BEGIN | None | 
|base for expression analyzer code | © | | 
Sprague DaSAP EDU ERD RERUN fanaa na fama mn nnn nnn nnn nn naw nnn nnnnann= { 
[Gets text block storage for use by |GETEXT | None | 
{Phase IM. Sets pointer to it. | | | 
jMoves constants into scratch | | | 
|storage and sets pointer to first | | | 
jconstant. Transfers control to { an | | 
|Phase IM | | | 
Bee ee ee 5 Eee maw re eas a a i ae J 

Table IM. Phase IM Translator Generic . 
a ee ge Cn he ee en a ee ee ng ee ee 1 
|Main Processing| . ; . | 
| Statement or Operation Type | Routine | Subroutines Used | 
mannan nnn nan nnn nn nn nnn nn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnnnnd 
{Selects function for processing | GNFUNC | GNXTRP | 
{Selects generic procedure | GNPLIG |GNDRTA, GNXTRP, GNFMID | 
{Selects generic Library routines; |GNBIFH {GNARID, GNCBEF, GNCACI, GNCTBI, | 
{determines function result { |GNGNCR, GNPRSC, GNSACH, GNSAPC, | 
| | |GNSBAR, EXPANL, GNSAPR, GNSBRT, | 
| | | GNSFMS | 
wan === === = $e nnn naan nnn nnn nn enn nn nnn nnn nnn nnn nnn nnn anennnnn| 
|Selects chameleon dummy and inserts |GNCHAM |GNXTRP, EXPANL | 
jit in relevant dictionary entry | | | 
}~------------------------=--------- --------------- }~------------~------------------—- { 
[Controls scan of text -- branches’ |EXPANL -|ARITH, LST1, SUBSPT, ASSIGN | 


[to processing routine | | . | 


to ee Le ee I 
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® Table IM1. 


[Routine/Subroutine| 


Phase IM Routine/Subroutine Directory 


Function 


ee aw ee wee | ee ee a a re em ew we re ew we wes oe ee oe ee we we er wn ee ew owen ee ee oe -4 


JARITH (IN) 
| 
JASSIGN (IN) 
| 
JEXPANL (IN) 


| 
|GNARID (IP) 
| 


eaten (1?) 
| anBoe (IP) 
jennie (IP) 
iencnee 
acne 
‘eueuad 

‘ GnernT 
tree 
leaeie 
freee 

| GNEOP 
chauce (TQ) 
cure 
[GNFO4 
eee 
hata (IQ) 
iencnen 
TeRoe (IQ) 
rampage (1Q) 
Vanbane (IP) 
\ enaxce 

lL gHeRBe 


| 
|GNSAPR 


{Calculates type of result of arithmetic operation (except **). 
| 

|Returns to calling phase with result. 

{Controls scan of text -- branches to processing routine. 


JIdentifies argument of built-in function and converts it to valid 
|type, if possible. 


|Selects generic Library routine; determines function result. 
iseneets relevant family member. 

|Sets up result type of a built-in function. 

{Checks and converts a decimal integer. 

|Standardizes argument code byte to a form for generic selection. 
{Selects chameleon dummy and inserts it in relevant dictionary entry. 
{Converts from decimal to binary. 

|anatyzes dictionary type. 


|Forms pointers and branches to routine GNEOP in text block storage. 
peeceedees end-of-block marker. 

{End of program routine. Frees blocks and releases control. 
[Identifies family member. 

{Selects function for processing. 


{Checks for nested function situation. 

rages up result type of a PL/I function. 

|Replaces original reference in text. 

|General conversion routine. 

nee entry relating to particular invocation. 

|Forms table of family member descriptions. 

{Selects highest mode, scale and precision of variable argument list. 
| Performs special argument check. 


|Calculates scale and precision of a function result. 


JProcesce® SUBSTR function and pseudo-variable arguments. 
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Table IM1. Phase IM Routine/Subroutine Directory (continued) 


1 
| Routine/Subroutine| Function | 
------------------ }-~-~~-----------=---=-----------------------------------------------{ 
| GNSBAR {Handles a subscripted argument. | 
| | 
{|GNSBRT (IP) |Examines all three arguments of SUBSTR and calculates the resulting | 
| |type exactly. { 
| | | 
{|GNSFMS (IP) |Replaces references to SUBSTR in text by a reference to another | 
| Jentry giving detailed information about the arguments. Places a | 
| {description of the resulting string in the text. | 
{ | | 
| GNTRID {Scans source text. | 
t | 
|GNXTRP jGets next triple. | 
| | | 
{LST1 (IN) {Calculates type and length of result of string operation. | 
| | | 
{SUBSPT CIN) [Adds type of array to stack. | 
i ca a a a as at a el an la a its saad ete a ences ee alas 
Table IT. Phase IT Post-Generic Processor ; 
ee ee en mt he ee ee A en ae Se ae ee ed 
{Main Processing| . | 
| Statement or Operation Type | Routine | Subroutines Used | 
}~----------------------—-+---------}---------------} ----------—-----=------------------4 
{Scans source text | PGTXSC | PGT01,PGEOB, PGEOP | 
}-~---------------------—----------- }---------------}} ------------ === 
[Analyzes type of function detected |PGFUNC | None | 
wa nn naa nnn nnn nnn nnn nnn nnn nnn nnn nn ann nn nnn nnn nnn nnn 
|Completes function handling | PGFNCP | PGNEXT | 
p-- ~~ ~~ - =n nn nn nnn fin nnn nnn nnn nnn nn nnn nn nnn nnn nnn nnn nnn 
{Detects ‘chameleon’ temporary | PGBUYS | PGBUY | 
|xeferences and deletes BUY and BUYS| | | 
|triples where possible | | | 
|---------------~-------------------} -------- -- -- += $f = nnn 
|Deletes ‘chameleon’ reference in an|PGPASS | None | 
jassignment triple and alters the { | | 
jargument triple to indicate an | | | 
{intermediate result | | | 
}-----~-----------------------------} ------------ ---} -------- ---- +--+ $f 
|Deletes all other references to | PGFNCM | PGBYAS, PGSELL | 
| 'chameleon' temporaries where { | | 
[applicable | | | 
iE EN Re ee Pe I ee EER EO AT REN bce mettenre ne eee heen eee ee a eee eek emeed 
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Table IT1. Phase IT Routine/Subroutine Directory 


mm ach a ee a a a a i a nw er a re we ee ee ee ee “1 


| Routine/Subroutine | 


Function 


| 
| PGASS [Deletes *chameleon* assignments. 
eer \apsasedes *Buy Assignment‘ triples. 
leanoe ieeceeuaed BUY triples. 
| pcEuYS |Processes BUYS triples. ! 
| PGKOs ieacis with End of Text Block conditions. | 
leenee oe end of program marker. | 
nee laeebates ‘chameleon' reference by an intermediate result where | 
| |applicable. | 
becenee |Processes function prime marker. | 
ype {Analyzes function, and determines the type of processing required. ! 
ee aac the next triple in source text. ! 
ieaaenn ene SELL triple. ! 
eeriee Necene text. | 
|Per01 [Determines action to be taken for a significant triple. 


Table IX. Phase IX Pointer and Area Checking 


¢ 
| 
| 


{Main Processing| 


Statement or Operation Type | Routine | Subroutines Used | 
[Nain scan routine SS~S=*dBUMPS I TEST,ERASER—t—t—S—S 
rable Tei, Shace tx HoueMnc/cubeemtine Directory 
[Routine/Subroutinel = ~~ ~~+Function ss sts—<‘—sS — 1 
(soe eeearegeetae gr, Sree near i 
coer {Tests operands for pointer and area data types 
[ERASER i aeareeclaaee bad statements. | 
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Table JD. Phase JD Constant Expression Evaluator 


ge ee ee ee Te ee ge ee ee 

|Main Processing| | 
| Statement of Operation Type | Routine | Subroutines Used | 
[pa — a nn nn nnn nnn nnn nnn nnn nnn nf nnn nn nnn nnn nnn nnn nnn nnn nnn nana 
{Initializes phase, gets scratch J INIT1 | None | 
Jetc. | | | 
~----~---—--------------~--------- f= ---- ~~ ---} --- += +--+ 5 === ------------------f 
[Scans text, for constant triples | SCANT |MORTXT, PREFIX, CONCAT | 
|--~------—-----~------------------- $--------------- $----------------------------------- { 
{Handles stacking/unstacking of | STAKOP | UNSTAK | 
| operands — | | | 


Table JD1. Phase JD Routine/Subroutine Directory 


| Routine/Subroutine | Function | 
ICcONCAT +~—~—=«s([ Detects constant string operands, performs concatenation, makes new | 
| |disk entry, and puts ref. in a slot for stacking. | 
| INIT1 latte scratch core for the stack, initializes slots and switches. 
|MORTXT . \ es next text block, resets pointer. 
{OUT |Puts out error message and aborts compilation if stack is not ! 
| | emptied. | 
operas |Detects unary prefixed constant, makes new list entry and puts ref. 
| jin a slot, for stacking. | 
leaaiat |Main scan routine. | 
| sTAROP |Push down stack handler. | 
oor oe if stack is full, and if so, aborts. 
oo ced entry from the stack. 
| UPTXT |Updates text pointer. ! 
babes kes [Releases scratch core and returns control to the control phase. 
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Chart 06. Aggregates Logical Phase Flowchart 
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Chart JI. Phase JI Overall Logic Diagram 
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* * * * . * ; * 

$0480 S00 8608548 Snseeresesececesse Seeeeeresesessess 

A 
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Chart JK. 


Phase JK Overall Logic 


Diagram 
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@e Chact JP. Phase JP Overall Logic Diagram 
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Table JI. Phase JI Aggregates Structure Processor 
ee ry a eet es ee ee eS ee a See 
| |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
[---------—------------—----------}---------------} ----------------------- === + ----- === 
|To re-order the STATIC AUTOMATIC |SCANA | MAP, MAPA | 
jand CONTROLLED chains and to 
{process structures 


| | 
| | 
~--------—------------------------ }--------------- }----------------------------------- 4 
|To scan down the COBOL chain for | SCAN | MAP | 
|COBOL-mapped structures | | | 
~~--------—--—--------------------- $--------- == --} == - - === === ----------------4 
{To transfer items from the COBOL | RECHAN | None | 
{chain to the appropriate AUTOMATIC | | | 
Jchain: | | | 
nanan naan nnn nn ann nn fn nnn nnn nf nnn nnn nnn nnn nn nnn nnn nnn nnn 
{To transfer control from IEMSI to {|TERMIN | None | 
| ITEMIM | | | 
pra a nn fin nn nnn nn nnn nnn nnn nnn nen nnn 
{To map COBOL structures | MAP | NXTRF1, NXTRF2 | 
a, i eT 
{To check non-COBOL structures for |MAPA | None | 
[constant length | | | 
~-——----~---=------——--—--------— $----~--------- —}-~---—-----------------------------4 
|To find the next member of a | NXTRFI | None | 
{structure | | | 
~------~----~---------------------- }----------—---- }----------—-—---------------------- 4 
|To find tne next element of a | NXTRF2 | None | 
| structure | | | 
bees oe Se a NB are etd select! aa od 
Table JI1. Routine/Subroutine Directory 

Soo ee ee ge ee ee ee ee er ea oe 7 
|Routine/Subroutine | Function | 
}---------—----~-- | ------- -- --------------- $n $n nnn nnn nnn =f 
| MAP {To map COBOL structures | 
I | | 
| MAPA jTo check non-COBOL structures for constant length | 
) | 
{NXTRF1 jTo find the next member of a structure | 
| | | 
| NXTRF2 |To find the next element of a structure | 
| | 
| RECHAN |To transfer items from the COBOL chain to the appropriate AUTOMATIC | 
| | chain | 
{ | | 
| SCAN : {To scan down the COBOL chain for COBOL~-mapped structures | 
I | | 
| SCANA {To reorder the STATIC, AUTOMATIC, and CONTROLLED chains and process | 
| | structures | 
| | | 

| TERMIN |To transfer control from IEMJI to IEMJM 
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Table JK. Phase JK Aggregates Structure Processor 


Ge ee Ee fg Un a Ea me oe are me peer gmp tee Ms eters ge ge ee Ee ge ee ee ee a ay 


| |Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
fo nnn nnn nnn nn fon nnn nnn nf nn nnn no nnw nn nanan nnn nena e enn 
|Scans AUTOMATIC, STATIC, and | CHNSCN }ADRDV, CHKDEF, MKDVD, MKRDV, | 
|CONTROLLED chains | . |] PROCDT, PROCST, SETBRF, TERMWS | 
Pm rn nef in nt on nae ann nae 4 
| Processes DEFINED items | CHKDEF |CMPIL1, INOBJ, PROCDT, PROCST, | 
| | | STBASE | 
prawn nnn nnn nnn nn nnn nnn nnn fn nnn nnn nn nnn nnn nnn nnn =f 
|Processes structures (calculates |PROCST |CMPIL1, INOBJ, ELSIZ | 


joffsets, multipliers, sizes, | | | 
jalignments and padding; generates | | l 
jobject code) { | l 


po--------——---- =~ === = nn nf nnn nnn nnn 2-2-2 === 


{Processes arrays (calculates | PROCDT |CMPIL1, INOBJ, LOADCN, SP54& | 
|multipliers and generates object | | | 
| code | | | 
| ann nn ann nnn fn nnn nn fn nn nn nn nnn nnn} 
|Calculates storage offsets for {| PS25 | CMPIL1 | 


jadjustable items in structures | | | 


on ae ne ce ee ae ae ee ne ee ee ee ae tn a a en | 


{Calculates storage offsets for | ALVACA | CMPIL1 | 
jadjustable arrays | | | 
|Calculates storage offsets for | ALVACIT | CMPIL1 | 
jadjustable strings | | | 
|Generates code to initialize string|SVARY |CMPIL1, INOBJ, IPDV, VOBJC | 


{dope vectors for arrays of varying | | | 
|strings in structures | | j 
a ee 
|Generates code to initialize string|VOBJC |CMPIL1, INOBJ, IPDV | 
{dope vectors for varying, | | | 
jnon-structured arrays | | | 
| —--~---- $— n nnn nnp n nnn nn nnn n n nn nnn 4 
|Generates code to calculate the | STBASE | CMPIL1 | 
|starting address of storage for | | | 
Joverlay defined items | | | 


a= ~~ == =~ === --- === === = =~ === == f= == $$ =f oa nn 


jAdds text skeletons to the output |CMPIL1 | None | 
| stream | | | 
Se ee Se ee 
|Makes dictionary entries for dope |MKDVD | ELSIZ | 


Jvector descriptions | | | 


~-----~--~--~---~---------- ------ ==} = ~~~ === == == == $= 


{Makes dictionary entries for record|MKRDV |MKCNST, CMPIL1 | 
|description vectors | : | | 
| --—----~---- = -- -$ = = = = = fon nnn nn nnn nf nin nnn nnn nn nn nnn nnn nnn nnn nn nnn 
|Generates code to set the address |ADRDV. | INOBJ, CMPIL1 | 


Jin a record description vector at | 
jobject time | 


| 

| 
| —-—----- nnn nn nnn npn fama nnn nnn 4 
|Calculates the length and alignment|ELSIZ | None | 
jof scalar data items | | } 
a a a a ai reer ates 4$------~----~---}---------~-------~------------------ 
{Sets offsets for BASED variables | BASED | None | 
a cl wales ice eee aoe 
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Table JK1. Phase JK Routine/Subroutine Directory 


[Routine/Subroutine| ~~~ +Function ———S—S—st~C~CSstsCSS 
[aDRDY (gE) [Generates addressing code for AUIOMATIC EUV. =~SCSCSCS;<7T 
JALVACA (JL) eines storage offsets for adjustable arrays. | 
| ALVACI (JL) ee storage offsets for adjustable strings. | 
| BASED |Sets offsets for BASED variables. 

VCaRDEE (JM) iiuecesece DEFINED items. 

loupEEs (JL) | agas text skeletons to the output stream. 

| ELSIZ i pebecuides Size of storage required for structure base elements. 
JINOBIJ (JL) ienieieiieus object code statements. 

|IPDV (JM) aera es code to set up primary dope vectors. 

|LOADCN (JL) idenecatee object code to load object registers with constants known 

| Jat compile time. 

| MKDVD aes dictionary entries for DVDs. 

|MKRDV (JM) ‘ees dictionary entries for RDVs. 


| 
|NXTREF/NXTRF1 (JM) |Gets the next structure base reference. 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| | | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
J 


|PROCDT (JM) | Processes arrays. 

| PROCST | Processes structures. 

| Ps25 |Calculates storage offsets for adjustable items in structures. 
|CHNSCN (JL) {Scans AUTOMATIC, STATIC, and CONTROLLED chains. | 

|SETBRF (JL) fours the reference to the current entry type 1. 

|SETDVS re the dynamic dope vector size for non-adjustable structures. 
{SP54 lesieaistes base element multiples. 

{STBASE (JM) Viet eee code to initialize starting address storage for overlay 


{defined itens. 


jnon-structured arrays. 


et TES ee SD aR a cm a ie ie ee ei St a i eas inh es ce a cae te age 8 ee Se RSD ee ee OE ee ee aD ee ee 8 ee ee ee Oe a Oe ee ee oe ee a et oe ee Ce a we eo a ee ee 


| 

| SUARY (JL) |Generates code to initialize string dope vectors for arrays of 
{ {varying strings in structures. 
ieaiae (JL) ectinates object code. 

Ivo (JL) {Generates code to initialize string dope vectors for varying, 
L 
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Table JP. Phase JP Translator Defined Check 


Se Oe ag ee ee ete ee Ee rae eae ee ne ee aaa 
{ |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
pon nn nn nn nnn nn nnn fo = == fo + == == === === == +--+ 
{Scans DEFINED chain? checks | IEMJP |GETCLS, GETLTH, STRCMP | 
| validity i | | 
|~------~- -------------------------- $--------------- }~------------------~--------~------- { 
|Checks that two structure | STRCMP | None | 
|descriptions are the same and that | | | 
pehey May be validly overlaid | | | 
Ser sonnets aes Sas acs a rain cn ees was Sa a Se a a ee es ee hs ci Ss a a ci eae eee nce cs ew ls J 


Table JP1. Phase JP Routine/Subroutine ‘Directory 

[Rout ine/Subroutine| ' Punction. { 
|GETCLS |Analyzes structure descriptions, and checks that all elements are of | 
jthe same defining class. | 


a 

icErLTE |Obtains length of string or numeric field from associated dictionary| 
i Jentry. { 
| TEMIP [Controlling scan of DEFINED chain; checks validity. 
on renee whether defined item is packed. | 
P20 inanee whether base defined item is adjustable. 
| sP200 {Tests whether item joie structure. 
| sps40 2 ieee whether defined item is coded arithmetic. | 
| psn |Compares base and defined item. 
| JP542 Meets whether defined item is dimensioned. ! 
| JP543 |Tests whether base code te arithmetic. ! 
| STRCMP | Compares givucture. descricticns: | 


Table JZ. Module JZ Compiler Control 

a rrr eae aaseeeseae = 
i {Main Processing| | 
‘a Function | Routine i Routines Used a4 } 
W--- + + fe 
Sea Ee the phase directory | LEMIZ |RLSCTL, ZUPL, ZEND | 
|for the second half of the compiler| 
| 


| 
| Entry to 05/360: BLDL | | 
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Phase KA Overall Logic Diagram 
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oe CESS BOO ee¢--- 8, 1Tp" 6 oe FOR $¢<.------- : CODE Sarat oe R° 
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@®Table KA. Phase KA Resident Control Module 


ee gg ee te oe a Boe EWR SN RNR yl gra Tie ny et et Wige tC ner Py he Pe go ee re ee ee 


| , |Main Processing| ] 
| Statement or Operation Type | Routine | Subroutines Used | 
{Handles KTAB BLDC/T operations |KAHBLD | ZTXTAB, KAHLOK, KAHULK, ZUTxIC, | 
| | | KAHERR | 
[Handles KTAB DR operation |KAHMDR {EAWERR, ZTXTAB, ZALTER) KARUEE 
fuandles KIAB ULDR operation (KANDA (KANUK { 
tiandies KIAB DEACT operation |KAHDAC.  ~{KAHULK~~SC~C~*~C<CS~S<;<C«tSCSCS 
tjandles KIAB FREE operation |KAHFRE (|KAHERR, ZALTER~~—~—~S*~C~S~S~S~S~S~S~S 
[Handles KTAB SCAN operation for |KAHSCN [KAERR, KAHLOK, ZTXTAB, KAHULK | 


{non-text tables | | | 


mn an a nnn nnn ann fn nnn nf nn nnn nnn nnn nn nnn nnn 


|Handles KTAB SET/SET Z operations |KAHSET | KAHERR, KAHULK | 
ED ED AAD GED REE AED ES EOD SRP ED CED eiay CD AED GUND GERESOLY GENS ES ES AED aD ED ED Ew RS SNS Sa eee RD i SD ED OES EP CE ERS ND AA CD GED NED CES ND nn re — -- - -- - - - - = | 
|Piace save area stack, DTCAs and j KBSTUP (KB) | None | 
{block list table in scratch storage| | | 
aaa ca a ea ieee lea Bo a a i eee te ie a eae J 


@eTable KAi. Phase KA Routine/Subroutine Directory 


| Routine/Subroutine| Function | 
‘aia leads ee ne eens 
ret aataiee KTAB DEACT operation (non-text tables) 
| KAHERR eae error message and aborts ! 
lagen \esgates KTAB FREE operation ! 
tL eaaeer oe a table entry |! 
ieaawing anaes KTAB DR operation (non-text tables) 
TeaeiBeS Handles FTAR SCAN operation (non-text tables) 
| KANSET | Handles KTAB SET/SETZ operations (non-text tables) 
| aaeee acrenies all KTAB operations on text tables 
aauee iapeaiee KTAB ULDR operation | 
Sai |Unlocks a table entry ! 
| KBSTUP (KB) a save area stack, DTCAs and block list table in scratch 
| | storage | 


| Reena enero e er ane a a ls came eos as marcas cs is in cm estos as wc a os a ew ae ca a aa oe ee, —— ons ee eee ee a ee ow ee we oe On Oe ee on er en ee oe a ee a oe ee eee ee ee eee 
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eabie KC. 


Phase KC Do-Loop Specification Scan 


Cr ee ee Se OR peo ee ER ee pee ft, en ee EY ee eae te ee op ee et ee See ee eee ee oe 


{Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 


or nn en a nn fn nn nf tr rn ee | 


{General text scan. | NXTRP * |SCAN (KA), DOLOOP, ONBLK 
iRecacon’eack fcc oNauie ~~ Soma ec 
{Initializes reordering scan after [DOLOOP {SCAN (FA), EXANAS, CVEND, NOvE, | 
{ITDO triple | | MOVER | 
[analyzes expression in loop speci- |EXANAS {SCAN (KA), MOVER, RSCAN 
| fication | | 
[Scans for ITDO nested in loop IRSCAN {scan (KA), MOVER” { 
| specification | | | 
[completes reordering scan at end of|CVEND {SCAN (KA), RSCAN, MOVER, MOVET | 
Jloop specification | | | 
Na ces eee ree er ese eae en area ae ct ae Soe a cae ape en emer ee conve ane eae ees a cee ce ee ces ge ec ce cs en erences comenen mmm ct cba is en enc a en we sc eh SE Ps enn ae iD a aS Ga an a ee ne ce cane cr sew ns J 
e Table KC1. Phase KC Routine/Subroutine Directory 
[Routine/Subroutine|=s—“i‘séS*‘SRcticM=d { 
cen comp lstae wecrdar ee Goan accend Gf dusp ecectticaticn’ “2 
on jInitializes reordering scan after ITDO triple 
‘eeaeas | Analyzes expression in loop specification 
i MguE ee triple into MOVE list 
ee Sake triple into REORDER list ! 
|MOVET {Moves REORDER list into text | 
oon {General text scan 
loneti jSets ON mask for occurrence of ON unit 
ere {Scans for ITDO nested in loop specification 
leben (KA) ieeaue text 


Mn i a a ce a a ae a a a ee re ee ee en wn et ea re ee ne nn a ee ee ne ee ee 


e Table KE. 


Phase KE Dictionary Scan and DO-Map Build 


a ae eee ee er ee ee ed a dee a ae wa RP 1 

{Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used: | 
ee en einen es emer cne tris nario enemas ncenentin rte cern erp sen erp nan lo a era nine mone a hc oe nicer ef 
jInitialization | KEINIT |KCDS, KESCAN, HTAB : | 
~--------—------------------------- $-~------~--~---}------------~--------~-------------+4 
[Dictionary scan marking unsafe | KCDSIN |HTAB, ZDICRF, ZDRFAB, ZDABRF | 
| variables | | | 
a ee a ee ee Se ee ee ee ee ee ee ee ee oe ee eee eee ee ee ee ee a ae a eae AD ee eee ee oe ee ee ee a | 
{Scans text and passes control to | KESCAN | KTAB | 


{triple processing routines | | | 


ei oe en a a see as oe ee ee eee ere cece we eee ce ce we ne a ce re a ae es ce a ca a he we a nn rn ne ee nee a ne ee ae ee re oe of 
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eTablie KF1. Phase KE Routine/Subroutine Directory 


2 AN AP SS YS SS A SS AS A A SS SS A A ES AAS LS SE AD SS AS OS SS GS SY ES SD SD ENS GS SED RD SD GED GS nS RS ED ES GE ED DD GD GOD ED WS OS oe ee ee ee ee 1 


| Routine/Subroutine | Function | 
iKcDSIN- [Dictionary scan marking unsafe variables = = ~~~ { 
| KECDME |Creates a DO-Map entry 
| KEDEND baaieeas the DO-Map entry 
| KEERRH |Produces termination error message and aborts ! 
| RINT . Veaicielgscien | 
| KELKUP \ aeawe list of procedures and pointers | 
| KESCAN |Scans text calling triple processing routines 
[xestcK [Wakes entry in stack | 
a csc se rc sete en ee a ae cea J 


@ Table KG. Phase KG DO Examine Phase 


SS Se ge en eee ee es ee a ern 

{Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
fan nnn nnn fn nnn nnn nm fama nnn nnn nnn nnn nnn nnn { 
|Main processing routine | KGMAIN |KGSCAN, KGSRGL, KGSORT, KGUSEN | 
aa - = | aE fon nnn nnn nn nnn nn 1 
{Tests whether an ON-unit could be {|KGOTST | KGSRGL 


jentered as a result of an interrupt| 
Joccuring at the triple being | 


| 

i | 

| considered | | 
Lt GU pEEESRE SIDI TaERERINE DEPP OtE 4{-------------~- }------------—------------------—- { 
|Transfers control to appropriate | KGSCAN | KGERRR { 
{triple routine | | | 
—- ~~~ = to }-~-~--------—---------------------- : 
|Considers a variable for entry into|KGUSEL | KGUSEN | 
jthe USE list | | { 
bao ee ees a a ee a eee eek <— ewee n ee o  rree ee ewe re ee oe re ee a ee ee oe ee oe ae oo J 

@Table KGi. Phase KG Routine/Subroutine Directory 

|Routine/Subroutine| Function | 
mn nn nnn nnn ann nnn nn nnn nnn a nn nnn nn nnn nn nnn 
[| KGDELT {Deletes non-compiler-created temporaries from USE list | 
| 
| KGDELU | Deletes unsafe variables from USE list |. 
{ { 
| KGERRR {Produces a termination error message and aborts | 
| 
| KGMAIN {Main processing routine | 
| 
| KGNICE |Checks that a dictionary reference is for a real fixed binary scalar| 
| jinteger variable | 
! { | 
| KGOTST {Tests whether an ON-unit could be entered from the triple being | 
| | considered | 
I | 
| KGSCAN j|Transfers control to appropriate triple routine | 
| | 
| KGSORT jSorts the USE list so that invariant variables appear first | 
| | 
| KGSRGL jMakes an entry in the SUBS/REGION list | 
| | . | 
| KGUSEL jConsiders a variable for entry into the USE list | 
{ | | 
| KGUSEN |Makes an entry in the USE list | 
J 


eTable KJ. 


Statement or Operation Type | Routine | 


4 
{To build the SUBS TABLE from the | KJSB 
|Subs/Region List and test the loop | 


Phase KJ Subscript Table Build 
Ce ee ee ene ERD or on eae pawns =7 


|Main Processing| 


| KJSRBXCH, KJSRCHKP, KJSRSOPC, 
|KJSRTDED, ZDRFAB, KTAB 


jinitial, step, and limit for use in| | 


|BXLE and 3XH code 


eTable KJ1. 


iF 
| 


FP ee ee eee ee cee eee eee oom em ome 


Routine/Subroutine 


Phase KJ Routine/Subroutine Directory 
qo--- -- -- ——- ---- ---- - -- - + +--+ 
| 


Function 


ma | 


KJSRBXCH 
KJSRCHKP 
KJSRSOPC 


KJSRTDED 


KJSRUSEL 


x 


x OR 


oh ae ER ED OD eS eto eewerene eaeons ene eens cee cme clip wre nae cur ae core aun cn ane nes an un an me aon ans eS en SE SS ED OO ee aan ae a em omens ee ee ee en en oe re 0 we oe ee om a en oe 


ODECN 


ONICE 


OPRSN 


|Builds SUBS TABLé from Subs/Region List and tests the loop initial, 


|jstep, and limit, for use in BXLE and BXH code 


|Checks that current loop is optimizable for BXLE, BXH loop control 


| code 


|Sets a series of flags stating the attributes of the expression 
jbeing analyzed 

{ | | 

jSets a series of flags stating the attributes of a given triple 
joperand within the context of the expression analysis 


|Sets the target DED in the dictionary entry for a constant to be 
jused in BXLE/BXH code. If necessary, new data dictionary entries 
jare created and the reference in text modified. 


jSearches the given USE list for a given variable 

I 

{Tests a given dictionary entry for a REAL, FIXED, BINARY, SCALAR, 
| INTEGER variable, or a BINARY or DECIMAL INTEGER constant 


| 
{Tests that a given variable is REAL, FIXED, BINARY, SCALAR, INTEGER. 


{ 

|Tests if a given dictionary reference is: 

ji. a variable of precision less than 30 bits or 

j2. a decimal constant of precision less than 8 digits or 
}3. a binary constant of less than or equal to 30 bits 
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@eTabie KN. Phase KN Subscript Optimization 


Te ee a eee BR ee ee ee ee ae a ee a ane a es er ene oe reel 


| ¢ |Main Processing] 

: Statement or Operation Type | Routine | Subroutines Used 
-------- - + + - fo fe ee ee ee ee eee 
|Sets up the physical. phase KN data |KNINIT . | KNCLOF 

jarea, KNDATA in scratch storage. | 

| KNCODE, which is a group of lower | 
|level subroutines, is also moved | 
Jinto scratch storage. The ass | 
| storage area is provided by KA. A | 
jscan is made of the chain of DO-map | 
jJentries, and subroutine KNCLOF is | 
|called for each to remove offsets, | 
jand prepare potentially optimizable| 
|subscripts for matching. | 
{Scans the subs entries of the | KNCLOF |KNCOMU, KNHASH, KNANAL, KNOPTY 
|subs-region table for the loop. It] 
{cleans up potentially optimizable | 
|coie, removes offsets, accumulating| 
|the total offset in the spare { 
joperand of the appropriate subs | 
|triples, and calculates hash values| 
{for optimizable COMA's. 


pow wen ae a ee oe 


1 
| 
| 

4 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 

r 
| 
| 
| 
| 
I 
| 
| 
| 


+— 


{Accumulates hash total and computes|KNHASH 

|hash for specified triple. | | 
mn nnn nn rn nn nf nnn rn nn nnn nmmnnenad 
JAnalyzes the type of triple operand|KNANAL | ZDRFAB | 
jand sets a return code value | | 1 
| accordingly. | 


{ 
{ 
{ 
! 
| 
t 
! 
{ 
i 
t 
! 
! 
{ 
{ 
| 
t 
1 
t 
! 
! 
! 
! 
1 
I 
I 
{ . 
1 
anhes 


5 
r=] 
@ 


fe cree eee nfs cee oe ee owe come eee ome 


F + 

|Analyzes the type of triple operand | KNOPTY 

jand sets a return code value | 

| accordingly. | 
}---------—----------—-+----------~ --}------- +--+ 
{Converts a decimal constant to | KNCOMU 

joinary and multiplies it with a | 

{given binary value. An option may | 

|be specified to allow conversion | 

jonly of the given decimal constant | 

{to binary. | | 


og 

a 

ry 

» 

w 
ee et 


ei KN1. Phase KN Routine/Subroutine Directory 
[Routine/s Subroutine} Function | 
mann nnn nnn nn nnn rn an nnn nnn ncaa nmn mere nnnn errno enna 
| KNANAL |Analyzes type of triple operand and sets a return code value 
| | accordingly. 


KNCLOF jScans subs entries of subs-region table for loop. Cleans up 
|potentially optimizable code, removed offsets, and calculates hash 
jvalues for optimizable COMA‘s. 


{ 
| 
| 
| | 
| KNCOMU |Multiplies decimal and binary values. 
{ 
{ 
| 
{ 


KNHASH |Accumulates hash total and computes hash for specified triple. 
| 
KNINIT |Sets up code and data areas in scratch storage, and scans chain of 


|DO-map entries, calling KNCLOF to remove offsets. 


| 3 
| KNOPTY |Analyzes type of triple. 
L 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
J 
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@e Table KO. Phase KO Subscript Optimization 


(SSS et ee re ee eS ee ee eS en a ee eee 7 
{Main Processing| Subroutines Used | 

| Statement or Operation Type | Routine | | 

}-------------------—--------------}---------------} -----=-----------------------------4 

{Initialization is performed for the]|KOINIT | ZLOADX, RELESE, 

|phase. The next DO-map entry in | |KTAB (Macro routines in KA), 

|processing sequence is obtained and| | KNOPTM, KOBXCH, KPUPDT 


|put in scratch storage. Module KP | 
jand KQ are loaded, and the | 
{Subs/Region Table is updated from | 
[the patch file. The iterative | 
{specification and DO-map are | 
{checked in order to amend iterative| 
{specification. A subroutine is | 
[called to form a match chain in the| 
|Subs/Region Table, once for | 
{Transforms and Invariants and once | 
|for commoning. When end of DO-map | 
jis reached return is made to | 
{Compiler control | 


ee ee es ce ee ee cee ee ee ene eee ne ee 


|---------—--—--~~-—--- ——-- ------ }------------ =} += n= += - 
|The sindex number for the loop is’ |KOBXCH |KTAB (Macro routines in KA), 

jset to zero. The routine looks at | | KOSNDX, KOPTCH 

{the DO-map entry and iterative | | 

|specification triples and makes a_ | | 

{patch over the ITDO and ITD*' | | 

[triples if BXLE/BXH is to be | { 

| generated for the loop | | 

nn a en nn fe nw nf ne + + 
|The match chain is processed and | KOMTCH | ZDRFAB, ZDICRF, 

jentries are made in the patch file.| |KTAB (Macro routines in KA), 

|The patch entries contain optimized| KOCVTX, KOSNDX, KOMAKC, 


{code for three types of 
|subscript. Patches are also 
jcreated for the BXLE/BXH code for 
{optimized loop control 


|KOPTCH, KOMCOM, KOMCHN, 
|KOMOVE, KOSSB3, KOSSB2, KOSSB1i 


aes ees ES eee eee cea Se el aoeee comme eee evens ee cemee cowe ees mee come ome ee a eee ee eee ee eee ee ene ee me ee 


{Creates part of patch for KOMCOM KOMOVE, KOPTCH 

{Transforms and Invariants. It is 

{called from KOMTCH | 

a nf nn 
|Makes an entry in the patcn file | KOPTCH |KTAB (macro in KA), KOMOVE, KOPCOM 


j{fixom the patch build area. Options| 
jare available to move the patch | 
|data to the patch build area before| 
jmaking an entry in the patch file. | 
|Entries are chained together if | 
[they are to be inserted at the same| . 
jpoint in text. A PTCH triple is | 
{placed in text at the point of | 
Jinsertion. The overwritten triple | 
jis placed in the patch | 


Ca ee ee a a ee ee rt a ee we rer cee wee rr es ere ee ec ee nes cer cw a re ee ee ere eee oe ew el, ew ee oe ne ee ee ee en ee en ee we ee ed 


ny ey ny a Ven nearer aie Speen 
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@® Table KO. Phase KO Subscript Optimization (continued) 


aaa Naa a aR a ak aaa i a a al al dae | 

; {Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
po- n-ne f= $= += == - -- == + === === === +--+ 
|Moves the triple to be overwritten |KOPCOM | KOMOVE : 


jinto the patch and moves the patch 
Jinto the patch file. The symbolic 
|reference of the patch is moved to 
{the PTCH triple in workspace. The 
{triple in text is then overwritten 
{with PTCH triple 
en nn rn rn nr en nn fe ne ef ee ee 
{The triples pointed to by the text |KOMCHN |KTAB (macro routines in KA) 
{references in the Subs/Region Table| 
Jelements in the current match chain| 
jare amended to refer to a value | 
|calculated in patch code. The | 
|jchain is then deleted and all | 
| 
| 
| 


af ee ee ee ee ee 


|COMA*s processed are marked in the 
|Suos/Region Table as dealt with and 
joptimized 
}---------—---------~---------------}---------------4----------—------------------------| 
|Tests the type of triple at the | KNTRTY | none | 
jaddress given and sets a return | | | 
{code accordingly | | | 
t-- a ee ae ce ae ee cee ae eee cae ae ee oe ee ee ee ee ee A ee ee ee eee -------—---——--—--}+ ns ee ee ee ee 
{Moves an item to the next available|KOMOVE j none : 
jaddress in the patch build area in | | | 
|scratch storage | | | 
~-~~-—--——--—--------------- ------} ---------- =} 2 +--+ == 
jAllocates a sindex register. The |KOSNDX | ZUERR, ZABORT 
{sindex register counter is 
|incremented, the sindex available | 
|counter is decremented and the | 
{symbolic register counter is | 
J incremented | 
es es a a 
|The first part of a subs list, con-|KOSSBS {|KTAB (macro routines in KA), 
|sisting of the SUBS triple and the | | KOSNDX, KOMOVE 
|COMA's before the first matched | 
jtriple, is moved to the patch build| 
jarea. The SUBS is chanced to SSUB | 
jand a symbolic register number is | 
jplaced in the second operand. A | 
| 
i 
| 


eS eee 


ee eee cee ees ae 
echo cee eevee ees SD eee 


Inull value is inserted in the 
j|second operand of the COMA triples. 
{All other triples are not moved 
5 a i a ee yc a a eee ne ete eS et a 
|Moves the last part of a subs list, |KOSSBE | KOMOVE 
jconsisting of the COMA's between | 
jthe last matched triple and the | 
{SUB* triple, to the patch build | 
jarea. The SUB" is chanced to SSB‘ | 
jand all COMA triples have their | 
| 
| 


jsecond operand set to null value. 
{No other triples are ‘moved 


Ce ne a se we we en ee ew bh ee ee ee 


‘ 
el 


fee we er ee oe ee 


oe = ce ee cee me ee ee a ee Se ee om Pe oy ee ee oe ee ee oe oe ee 
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® Table KO. Phase KO Subscript Optimization (continued) 


|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
{Tests whether any operand in a list|KOCVTX’ | 
Jof triples is a reference to a | | 
jcontrol variable of the current | | | 
| Loop | | | 
~~-------~--~----=-----------------}----~--- -- +} ++ - == +--+ + ---- === -- 4 
|The message ‘Invalid input type V_ |KOEROR | ZOERR, ZABORT | 
{to optimizing phase KO‘ is put out | 


KTAB (macro routines in KA), KNTRTY| 


KOSSB3 


bon aed 
| 
| 
! 
1 
I 
! 
! 
I 
| 
! 
! 
! 
| 
(| 
| 
! 
! 
{ 
J 
| 


|Moves a subscript list into the 
{patch build area changing the 
|SUBS/SUB" triples to SSUB/SSB'‘. 
|All matched COMA expressions are 
{copied with amendments as follows: 
]} (1) References to the control 
|variable are replaced by references 
jto the step. 

| (2) All additive invariant parts of| 
{the expression are deleted. 

{All unmatched COMA expressions are | 
|replaced by COMA - NULL | 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
Se ee ee ee FRIRTY, KOWDYE, ROUARC, KGssee, 
| 
| 
| 
| 
| 
| 
| 
| 
4 


KOSSBS, KNTRTY, KOMOVE, KOSSBE 


ome ee Gee come eee eee omen comme onfios 
ee ee oe ee eeree cone oe eee Cane cee mee cone anes ee 


jA subscript list is moved to the | KOSSB2 | KNITRTY, KOMOVE, KOMAKC, KOSSBE, 
|patch build area with SUBS/SUB' | | KOEROR, KOSSBS 
{changed to SSUB/SSB* triples. All | 
j|matched COMA expressions are copied| 
Jexcept the dictionary references to] 
jthe control variable which are | 
|xeplaced by dictionary references | 
{to the ‘initial’ elements. All | 
Junmatched COMA expressions are | 
|xreplaced by COMA - NULL | 
|~----------------------------------}---------------} -----—----------------------------- 
[A subscript list is moved into the |KOSSB1 | KOMOVE, KOSSBE, KOSSBS 
{patch build area with SUBS/SUB' | 
|triples changed to SSUB/SSB" 
jtriples. All matched COMA | 
Jexpressions are copied. All | 
Junmatched COMA expressions are | 
{replaced py COMA - NULL | 
}-----------------------------------}---------------}----------------------------------- 
{Produces a binary constant, if it |KOMAKC |KOTSTO, KNTRTY, ZDICRF, KOADDC, 
jis possible, given as parameters | | KOSUBC, KOMLTC 
jthe dictionary reference of two | 
{constants in the operands of a | 
|given triple. A dictionary entry | 
jis made for the new constant, the | 
|dictionary reference of which is an| 
| 
| 
| 
| 


chee ete eee ee cee ee eee 


joutput parameter. A return code 
|value is also given indicating 
jwhether or not such a constant has 
| been created 

|A dictionary entry is obtained from|KOTSTO | ZDRFAB, KNCOMU, KOPREC 

{the given dictionary reference and | 
jtested to see if it is for a 
[decimal or binary integer constant. 
{If it is, the effective precision 
{is found and the constant is 
{converted to binary if necessary 


tL... ee Le ee en ha a 


enh wee eee eee eee Oe ees ee oe ee ee ee 
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@e Table KO. Phase KO Subscript Optimization (continued) 
a ee ee er ae 
| {Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
wa a a fe + e+ ee 
{Calculates the effective precision |KOPREC | none : 
Jof the binary fullword given | | { 
pana nanan nn nnn ff == = = 
JA binary fullword result is | KOMLTC | none ‘ 
Jobtained by multiplying together | | | 
jthe two input binary values | | l 
pom nn nnn nn nnn nnn nnn fn nnn nnn nn nf nnn nn nn nnn nnn nnn nnn ne 
|A binary fullword result is | KOADDC | none i 
Jobtained by adding together the two] | | 
Jinput binary values | | | 


|A binary fullword result is 
jobtained by the subtraction of the 
{two input binary values | 
}----------~--------------—------ ---- 4 -- ——- +--+ + ff +--+ ee eee 
{Converts a decimal constant to | KNCOMU | ZDRFAB i 
|binary and multiplies it with a’ | | 

|agiven binary value. An option may | | 

|be specified to allow conversion | | 

Jonly of the given decimal constant | | 

jto binary | | 

|Scans the subscript lists of a | KNOPTM |KTAB (macro routines in KA), 
{DO-ioop looking for matching COMA's| |KNSECO, KNTRMV, KNCHRG, KNCMPR, 

jox COMA - expressions which are | KNALRG, KNOMAC, KNMKVL, KOMTCH 
|possible candidates for 
|transforming, moving out of the 
J|loop as invariants, or commoning 


res ee es ee vw ne me ee eee ee ee 


|Forward scans the Subs Table entry |KNSECO 
| (equivalent to a backwards text 

jscan) looking for the first group 
{cf COMA's that are optimizable as 


jindicated by a switch 


none 


+-——— 4 


|Analyzes the type of triple operand| KNANAL 
jand sets a return code value | 
jaccordingly | 


w~ a= == 8-8-8 nnn nf nn nf nnn nnn nnn nnn nnn nnn 


{Clears the match chain | KNOMAC |KTAB (macro routines in KA) 

|Match area code is compared with | KNCMPR {KTAB (macro routines in KA) 

jtext. The start point, finish 
jpoint, and length of matched code 
jis passed back. Only complete 
|COMA's or COMA - expressions are 
|matched 


KNTRMV {|KTAB (macro routines in KA), 
|KNTRTY, KNANAL, ZTXTAB, KNCOMU 


|Text between specified triples is 
|scanned. Cleaned up triples are 


|moved into scratch storage 
ies ee ee a eee eae 
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@ Table KO. Phase KO Subscript Optimization (continued) 
a a er ae eee eee oe re ee 
. {Main Processing| 

| Statement or Operation Type | Routine | Subroutines Used 
|A list of dictionary references of |KNMKVL | 
jall variables in operands of | | 
| 

| 

| 

| 


’ 
t 
1 
t 
! 
| 
§ 
! 
! 
! 
’ 
! 
' 
’ 
' 
! 
t 
! 
{ 
! 
‘ 
{ 
{ 
I 
i 
| 
‘ 
! 
] 
| 
5 eae 


|jtriples in a scratch work area is | 
jmade. The list is terminated with | 
ja halfword of zeros. A flag is | 
Jalso set if any of the variables in| 
jthe work area are unsafe | 


SE SS ED A OO chk EY SE SY EE PD SAD AOD LS COD ERED ca OD <a ay 





------}---~----------- 4 ------- -------- +--+ ---- ---- +--+ 
|A check is made to determine if the|KNCHRG | none 

{given region entry is an end region| | 
|for commoning for the matched code | _. | 
jin the scratch work area | | 


JA check is made for region | KNALR |KTAB (macro routines in KA), KNCHRG| 
|boundaries between specified | on { 
|subscripts i | 


Oe ee ee ee EE UD OS Oe eS ee eS TE Go OY a ae ee on oe ae PEE oH ws as eae Eee es ae 


adie cme cee cee ees odes cee ee ee ee ee oe 


|Controls the search through the | KPUPDT |KTAB (macro routines in KA), KPSSUB| 
Jpatch file for SSUB triples and the| | | 
{subsequent processing of the | | | 
|xestricted types of expressions | , | | 
{found after the SSUB triples | | | 


a nn a fl a a af a ne |] 


| Shortened version of phase KJ. | KPSSUB |KTAB (macro routines in KA), | 
| Processes those triples following a| | ZDRFAB, KPCHKP { 
|SSUB triple | | | 
i ia eee a a W----------} --- -- —- - - +--+ + +--+ +4 
|The USE list is searched to see if |KPUSEL |KTAB (macro routines in KA) 
{the given dictionary reference is | 
jcontained in the list. A return | 
|code is set depending on the part | 
jof the USE list in which the | 
|xeference is found | 
}—---------—---—------ -—-- - -+- —------- —- 4 -------- —- -- -- +}. -------- -- +--+ 
|Examines an operand of a triple and|KPSOPC | ZDRFAB, KPUSEL 
jsets flags in a code byte giving | 
{the information required on the | 
joperand during the analysis of the | 
jexpression within which it occurs | 
+ 


RS EN EE A ET OP CE ED RENAUD EES ED OE EY AY AE OE EL GENES CENA OE ES AED EN eS SE ERED CONS RE ANE MIE UD OE EY ISS OS ome et oe ee wt ee ew ew es we es wes we oe 


{The operands of triples following a|KPCHKP | KPSOPC 
|SSUB triple are examined to 


|determine the type of expression 


fe ee cee ce 


fee cee comm come come anlies oem amen eee mee cmee cakes cave eam eee amet een OE 
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® Tabie KO1. 


Phase KO Routine/Subroutine Directory 


| Routine/Subroutine| ; Function 

[KNALRG |Checks region boundaries-between specified subscripts | 
fore lanretee type of triple 

i Neake {Checks for end region for commoning 

IaRONER ieeuates edde in two matching areas 

NeacoMe |Multiplies decimal and binary values 

Seen ee variables in scratch storage 

TEnOHAG {Clears the match chain . 

Game leeate subscript lists of DO-1oop for matching COMA‘s 
ae aanicaee type of triple 

acne Vee Subs Table entry for optimizable group of COMA" s 
eee i Seaiuce offsets, tidies up, and moves code to match area 
ae igses triple type 

egande |Adds two binary values 

een havens DO- loop and patches over ITDO and ITD" triples 
NeoeeR jTests for reference to control variable 

| KouROR bates . 

ene [tnitialization for physical phase 

SeOaKe j|Creates binary constant 

FyOnCuN | Amends triples to refer to value in patch 

ioueou eae part of patch for transforms and invariants 
ieounne jMultiplies two binary gauss together 

sceeoue Neves item to next place in patch build area 

;ROMEEE leases match chain and makes an entry in patch file 
tRGESON | Gueail tae triple in text with PTCH triple 

geet ronesins effective precision of binary value 

| KOPTCH [Makes an entry in the. patch file | 
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@® Table KO1. Phase KO Routine/Subroutine Directory (continued) 


[Routine/Subroutine| = = = | Function 1 
[KOSBSC |Gets next entry from Subs/Region table © { 
ieoawon JAllocates a sindex register ! 
ionic aNiceue last part of Subs list to patch build area ! 
(eoRsEs |Moves first part of Subs list to patch build area ! 
perenn ee a subscript list to patch build area ! 
eee eyes a subscript list to patch build area 
iROasHS |Moves a subscript list to patch build area 
trosune |Subtracts two binary values | 
i ROTSTO laesee if dictionary entry is for binary or decimal constant | 
| KPCHKP cae operands of triples in SSUB list ! 
i epnene |Sets a code pyte after examining a triple operand ! 
‘Keanu {Processes triples following a SSUB triple in a patch 
— |Searches patch file for SSUB lists 
lebueee |Searches USF List for given dictionary reference 


lose eee ee eee ee Le ee ee cee ae eee Ome ee ee a See ae cee ee ee ee Oe es ee ee Oe Oe ee GP Om em a re Oe ee 0 et oe SO Oe www es ee ew 
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@Tabie KT. Phase KT Pseudo-Code Scan 


|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 


$ + 
{SCINIT Initialization |LA000S — |UT01,UTO2 


~-~---------------- =~ ------------}}---------------f -------------------------------- +f 
}sc1 Search for triple of | LA0010 | UTO1, UTO3, UT06, UTO7, UTOS | 
| interest | | | 
cee a eal ie ae aa are eee er ee ee ee 4 
{| sc2 Move current triple then {LA0011 | UTO1, UTO3, UT06, UTO7, UTOS8 | 
| search | | | 
| ~---~-------~---~------—---~-------}~--------------}-----------------------------------4 
|sc3 Delete current triple then |LA0012 | UT01, UTO3, UTO6, UTO7, UTOS8 | 
| search 

{sc4 Skip current triple - text 

| wanted 


en eae oe oe rr oe ee er ew ow oe 


Gt 
or 
ot 
a I 
! 
! 
i] 
t 
{ 
| 
{ 
| 
{ 
I 
! 
J 
t 
( 
! 
! 
t 
‘ 
! 
! 
‘ 
' 
| 
1 
! 
' 
! 
' 
t 
mene codes 


{ 
4 
| 
\ 
: r 
| Sco Skip current triple - text |LA0021 UT06 | 
| free | 
4 
I 
| 
+ 


| SC6 Move current triple - text 
| wanted 


! 
! 
! 
{ 
{ 
{ 
! 
' 
! 
' 
I 
! 
! 
t 
J 
' 
! 
t 
! 
! 
' 
I 
t 
! 
! 
I 
! 
t 
t 
' 
| 
be 


-+ 
|Sc7 Move current triple - text {|LA0026 | UTO3, UT06 | 
| free | | | 
}-----------------------------------} ---=-----------} === --- === === 
{Scio Symbolic input pointer to |{LA0035 | UTO1 | 
| absolute | | | 
nana nnn ann nn nn nn nnn nnn nf nnn nnn nnn nnn nnn nn nnn 
|sc11 Skip pseudo-code - text | LA004O0 | UTO6 | 
| wanted | | | 
a a eee eeesaa 4 
]sci2 Skip pseudo-code - text | LAO041 | UTO6 | 
i free | | . | 
wanna nn nnn nn nnn nnn nnn nnn nnn nn nn nnn nnn 
[MV2 Move user pseudo-code to | LA0050 | UTO4 | 
| contiguous OP | | | 


; 4 4 
| MV3 Move user pseudo-code to OP |LA0055 | UTO4 | 


a= = = =~ = = nn nf nn nnn nf nnn nnn nn nn nn nnn 


[MV3A Move user triples to OP | LA0056 | UTO3 | 


}----~----—--------------—------—}--------------} ------------------------------- 


{DV1 Generate dope vector for | LA0070 | UTO7,UT10,0T11 | 
| based aggregate | | | 


Dn ee ce eee ee om os ee en ee aw om ee ee Ee een eens evens ean ee rR (AL a eee ena Ne ep Se ON Sn Ce Pe ae ky a | 
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e@eTable KT1. 


.------------- 
| Routine/ Subroutine 


- 
| 


Phase KT Routine/Subroutine Directory 


Function 


ee ee ane ae ae Se ee we ane a ee ree cee oe one ee ee ee ee re oe oe ew oe en ee oe 


mee eee ee _--4 


ae a ae an oe a rer ee ee rn rn en ret rer sn en = = =f 


|DV1 
sige 
|Mv3 
|MV3A 
raciaes 
{sca 


| 
1sc2 
| 


sca 
{sca 
{SCS 
oe 
léc7 
eee 
aes 
tact 
seal 
|sc12 
prod 
| uro2 
| 03 
‘pros 
| pros 
| ur06 
| ro? 
| pros 
| orto 
| rad 


bo ee ee ee Lee ee ee ee ee ee ee ee ee ee ee OP ee ee ee ee ee a ee ee a ee eee ee a ee ee a a ee ee a a ee eee 


|Generate dope vector for based aggregate. 
| ; 
|Move user pseudo-code to contiguous output text. 


|Move user pseudo-code to output. 


|Move user triples to output. 


| 
|Initialize input and output text blocks. 


{Searches for triple of interest to user as indicated 


|Move current triple to output then search for triple 
juser. 


|Delete current triple then search for triple of interest to user. 


Skip over current triple and mask input WANTED. 
Skip over current triple and mark input FREE. 
Move current triple to output and mark input WANTED. 


Move current triple to output and mark input FREE. 


onvert symbolic input pointer to absolute. 


n Oo & 


kip over input pseudo-code and mark input WANTED. 


kip over input pseudo-code and mark input FREE. 


a On 


et a new input text block. 
Get a new output text block. 
|Move pseudo-code to output. 
|Move triples to output. 


| 
{Move text to output. 


|Test for end of block and chain to next block if necessary. 


{Convert dictionary reference to absolute. 
|Move input pseudo-code to output. 
jSet adjustable bound values in a dope vector. 


{Convert output text references to absolute. 


Move input pseudo-code to output and mark input WANTED. 


ove input pseudo-code to output and mark input FREE. 


by TRT table. 


of interest to 
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eTabie KU. Phase KU DO-loop Control and Merge Patches 


DS a ge nt ae es re ON ag Te Mee ee ORE! ie Bea ee ee, ee eee ee a ae ee 


e 2 1 
| {Main Processing| | 
| Statement or Operation. Type { Routine | Subroutines Used | 
{The phase KU control routine. This|KUMAI _ |[MV3A(KT) + all routines in modules | 
|is highest level routine in phase | |KU and KV except KVJUMP, KVSSUB, | 
| | | KVSSBP | 
Fee prea. ee ee ema ee ee ed ee { 
jPhase initialization | KUINIT | ZLOADW, ZUGC, SCINIT(KT) | 
fac cn cnn nn nn aif err fanaa nnn nn nn == === -- + 
| Processing initialization performed|KUSETS | none | 
| before each return to main scan | | | 
}---------—-----—------——---------- foaa-——-- === fanaa nn nnn nnn === === : 
{Primary phase scan of text | KUSCN1 |SC3(KT), SC1 (KT) | 
[a nn nnn nn nn nnn nnn nn nn nnn nnn nnn nnn nnn nnn nnn 
|Secondary scan of DO-loop | KUSCN2 | SC3(KT), KVERRS | 


jspecification elements only { | | 
a ann nnn nn nnn nnn nnn fon nnn nnn nn nen nnn nanan mann nn anna 
{ITDO triple test routine. Loops | KUITDO . | KVERRS | 
jthat are optimizable are detected | . | | 


~~--------------~--------------—— ~~------------}-----~~-----—---------------------4 


|CVv and *CV triple processing | KUCVAR {SC5(KT), ZDRFAB, KVERRS | 
| routine | | , | 
}--------------~--------------------f------------ === -- == =~ == == == === =f 
|Determination of type Of step | KUSTEP | ZDRFAB | 
oo an ne ef nn ef + a ne ne ee 
| Fill in loop control skeleton for |KUSKL1 | ZDICRF, MV3A(KT), MV3(KT) { 
jvariable step with no sindex | | | 
| registers | | | 
~-=~---~---~------------------=----}-------- —-----} === ----- ------------------------ =| 
|Fill in loop control skeleton for |KUSKL2 |MV3A(KT), MV3(KT) | 


|variable step with sindex registers]|. | | 
nanan a8 nnn nanan nn nnn nf nnn nnn nnn nn nnn nnn nnn nnn nnn nnn ne 
{Fill in loop control skeleton for |KUSKL3 | MV3A(KT), MV3(KT) | 
{constant step | | | 
| --  nn n nnnn nn th nnn nnn nnn r cence nnn nncnnd 
{Phase finish. Release scratch | KUENDS | ZURC, RLSCTL, KVERRS | 
|storage KV and patch file. Return | | | 
jto control | | | | 


------- ~~ -- + + ns =] 
|Patch triple processing routine. | KVPTCH | ZTXTAB, MV3A(KT),° KVSSUB, KVERRS | 
|Each patch is located and inserted | |KVITDP, KVSSBP, KVCOMA, KVCOMR, | 
! : | | KVJUMP | 
}------------------------—-------— {--—--—--------- }~---------------------------------- : 
| Process all COMR triples | KVCOMR | none | 
| ------------------- --=- -- ---- =} = - =f nn nnn nnn nnn nnn nnn nnn 
|Process all COMA triples | KVCOMA | none | 
anna ann nn nn nn nnn nnn fin nnn nn nnn ann nnn nnn nn nnn nnn nnn nnn nnn 
{Process JUMP triples. Used only | KVJUMP | MV3 (KT) . | 
|while processing a patch | | : 
fe 
|Process SSUB triple. Used only | KVSSUB | ZDRFAB, ZTXTRF | 


{while processing a patch | | | 


aa = = = = nn nnn nnn nf nn nn nnn nn nnn nn nnn nnn nnn nn 


| Process SSB' triples. Used only | KVSSBP | ZTXTAB | 
{while processing a patch | | | 


| a eee eee ee a ee ane a ae ae Do new eee an ee em em ae ees ey Se ae ame oes ame ae eae anne ee Se Re ey ee pap ep ey | 
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@eTable KU. Phase KU DO-loop Control and Merge Patches (continued) 


Cres a ae en ee ee 0 ee ee ee ne nee ee ern 7 

|Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
~------------------—------------—- }---------------}---------------------------------—-] 
{SUBS and SURO triple processing | KVSUBS | ZDRFAB, ZTXTRF, MV3A(KT) | 
| routine | | { 
|p —--~- nnn nnn tonae-2-- = =~ =~-- $------~--~~----==------------------ { 
]5UB" triple processing routine | KVSUBP | ZTXTAB | 
a nnn nnn pon rn nnn npr nnn cnn nnn wana meen nna 
{ITis" triple processing. Insert | KVITDP |MV3 (KT), MV3A(KT) | 
jepilogue into text for optimizable | | | 
| loops | | | 
fam arn nnn nnn an nnn fn nnn nnn nnn nnn nnn nn nanan nnn nnn nwconnnnnd 
{Set up phase error message number’ |KVERRS | ZUERR, ZABORT | 


Jand parameters | | | 
wa a a9 = $= a 5 af nnn nn nnn f nnn nnn nn nnn 
{Search register alias table for | KVALAS | None | 
|SSuR register | | | 
bee A e  eat a e a e ee es Bee ee be ene ae eae J 
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a 


efTable KU1. Phase KU Routine/Subroutine Directory 


(eee a a aa a aaa a a 7 
| Routine/Subroutine | Function | 
aa ok a a sa cai de cs a Ee cs ca ea oe ee a eee 4 
| KUCVAR | Processes CV and *CV triple in optimizable loop 

| 

| KUFNDS {Phase finish. Releases KV, scratch storage and patch text 


| 
{KUINIT 


| 

[ 

| 

| Initializes phase KU processing | 

aera |Detects DO-loops flagged as optimizable ! 
 KUMAZN {Phase KU control rovtine 
ae facigasy scan for phase ! 
eueewD an for DO-loop specification elements 
musees | Processing initialization 
oer jSets up variable step sindexes available loop control code 
leds {Sets up variable step no sindexes loop control code 
eer |Sets up constant step loop control code ! 
| ROSTER |Determines type of step 
nine aeceahes register alias table for SSUB register ! 
ico ene COMA triples ! 
leveone {Processes COMR triples ! 
ievanne rapeeeseen phase KU errors | 
ase |Inserts loop control epilogue | 
fone {Processes pseudo-code within patches 
eee |Processes PTCH triples by reference to patch file 
eee jProcesses SSB’ triples occuring within patches | 
Nagesue | Processes SSUB triple occuring within patches 
iecuse | peeweseus all suB" triples ! 
Neuaue ibeseute SUBS triples 


[ 
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Chart MG. Phase MG Overall Logic Diagram 
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Chart OP. Phase OP Overall Logic Diagram 
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®Table LB. Phase LB Pseudo-Code Initial 


CS ee Te a ee ee ee ee er ee 1 
] {Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
ee ee Ee ED ED ES SE SD ES ae a a ED Ee We RS SED See Gee ee eee ae ee Oe ee ee ee ee en a pS eS Ee ee ee ES ee a ee oe om — oe ee we ee ee wn ee ee oe ee Oe a © oe oe ew owe --—- 

J [Scans text for PROCEDURE, BEGIN, | SCAN |SCINIT, SC1, SC3, SCS (all in kT), | 
jand ALLOCATE triples | |SFSCAN, ENDRTN, MAIN, SCAUTO, | 
| | | AUTO12 l 
faa aa nn nnn nnn np nn nnn nnn nnn nn nn nnn nnd 
|Scans automatic chain | SCAUTO | MAIN | 
pra nnn nnn nnn nnn nnn fn nnn nnn np nin nnn nn nn nnn nnn nnn meen anna 
{Processes INITIAL attribute | MAIN | CNSTWK, ARRENT | 


{dictionary items | { | 
faa a a nn nnn nn fn nnn np nnn nnn nn nnn nnn 


| Processes IDV statements | AUTO12 | ARRENT | 


t + 
{Processes INITIAL arrays | ARRENT | CNSTWK | 


Dae mn an ee ee ee ee ee eh ee dh ee ee I 


Table Lil. Phase LB Routine/Subroutine Directory 


SOT ee et ee re eT ee ee EE eR et ee ae A we a one ee SP eg ye ee a ge teed a oe ee eS E 


jRoutine/Subroutine | Function | 
WAnEENT MEG) (ceneeseee te ipties, aad) paeude-code for arcaje deciaved’ wich INETIAL<. | 
{| AUTO12 ee IDV (initial dope vector) statements. ! 
| CNSTWK peer initialization triples. ! 
| ENDRTN |Releases phase and scratch storage. ! 
rer ere INITIAL attribute dictionary items. | 
fore ake text for PROCEDURE, BEGIN, and ALLOCATE triples. 
|scaoTo tess AUTOMATIC chain. 
| SFSCAN [scans through second file statements. | 
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Table LD. Phase LD Pseudo-Code Initial 


Gg ee a rg a ee ae ee ee Wine aap aly eg keg ee 


[Main Processingj 22 2... °° 4 
| Statement or Operation Type | Routine | Subroutines Used | 
(scans the STATIC chain for any {STATIC ENDRTN, ARRENT, CNSTWR, 
el sal wl |  O  e e r 
Table LD1. Phase LD Routine/Subroutine Directory 
[Routine/Subroutine) = tttiti‘its~™S “Function ssts—SsSSSS 1 
[ARRENT | —~—~—«*([ Processes the initial value string for arrays. = 
| CNSTWK lexeaees constant entries for initial values. : 
| CNVERT {Converts decimal integer constants used as replication factors to 
| | fixed binary. | 
{ ENDORTN fers the phase and scratch storage. 
|GAA1 poe array initial value string. | 
ene | Ce slot for converted constant for arrays. | 
oe {Calculates the equivalent length in bits or bytes of a constant for ! 
| |variable or adjustable length strings. | 
isp ieeene the STATIC chain. |! 
Varsean raaneebene elements of structures. ! 
aoade eats initial value list. 
Vgaien |Resets initial value entry. 
| 519999 fens slot for converted constant for scalars. | 
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@Table LG. Phase LG Pseudo-Code DO ee 


f Seater ee op ee Re wee eS Rees oe ee ee Sm aR a a | 
]Main Processing| | 

| Statement or Operation Type | Routine | Subroutines Used | 
mann nnn nn nnn nf 8 $—---~--=-~—-~----------------------4 

[Scans text | LG0002 {SC1 (KT). | 
onan nnn nnn nnn nn nn nnn nn nnn nn nf nnn nn an nnn nn 
|For iterative DO triples, pushes |LG0011 | PSHDWN, SC5 (KT), CVSCAN | 
{down stack and examines control | | | 
|variable Ey es | { 
FE AS ED NY CT EE ND EP EE AS SE ED ES ED eS ee Se ED ee oe ee ee ee ewe 6 eS a ee ewe nr nnn nnn - - - - -- |] 

|Pushes down DO stack | LG0013 | PSHDWN | 
pon nnn nn nnn nnn nnn nnn nn nnn nn nnn nnn nn wenn nnn nnn nnn nnn nnn nnn nanan | 
|For iterative DO" and DO* triples, {LG0012 | EXPEVL, POPUP | 
jpushes up stack and removes top | | | 
jentry iz | | 
AY A SY A SS AS A SS SS SS eS T > ED ED CUD GED ED ED GES E> ED ee ee a ew nn nr - - -- | 

|For CV triples, reverts to normal |LG0015 | EXPEVL | 
| scan | | | 
SS ccnES= ESP EPEE en GEP TIP SRDRIRRRSRRN Sainte fanaa nnn nf nnn nnn nn nnn nn nn === 

j¥or TO and TO* triples, examines |LG0017 | EXPEVL, TESTOP | 
Jarqument and assigns to temporary, | | 
[if necessary I | 
~--------—--------~---~---------- $--------------- }~~~-------—-—--------------—----—- : 

|For BY and BY‘ triples, examines |LG0019 | EXPEVL, TESTOP | 
jexpression and determines signs of | | | 
{constants; assigns. variables to | | | 
| temporary | | | 
|For WHILE and WHILZ‘ triples, marks|LG0021 | CODE3 | 
{loop as iterative; generates test | | | 
|jtriples | | | 
~----~-----------------—-——-- —----} ---------- —----} --- = -- = 4 

|DO EQUALS triples, assiqns |LGoO0o24 | | CODE2, TESTOP | 
jexpression as a temporary; | | 
|generates code to control loop if | | | 
jend of specification | | | 
on ae ee ee cee ee ee ee ee ee ee ee ee a ee ee ee ee ee ee ee ee ee ee ee ee ee oe eee eae eee mre he rn ne ee ee reef 

|Sets up control variable text in DO|CVSCAN |CVCOPY, PSTYP0, PSTYP1 | 
| stack | | | 
| ----------—-- ~~ --- = -- ~~~ ff nnn nnn nnn nn nn nnn nnn nnn 
{Generates loop control code | CODE2 | CVCODE, DICENT, ‘COMPAR, SWITCHP, | 
| | | LMV3AU, LMV3A5, PSTYPO, PSTYP1 | 
pana nnn nnn nn nnn np nnn nn nnn nnn nn nnn 
|Tests expression result type and | TESTOP | DICCHN, LMV3A5 | 


jassigns to temorary if not constant| ; | | 


a a fn fn en en ee | 


{Moves text from DO stack to output |CVCODE | LMV3AU | 
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Table LGi. Phase LG Routine/Subroutine Directory 


"7 ee oe a ee ee ee a ee == 7 ee ee ee ee ee ee we ee we re re we en a Oe ee ee ee BO OO ew SO Ow we ww wwe we eee www ee eee we oe eee 


[constant. 


| Rout ine/Subrout ine| Function | 
(comit  cene ares ieee em ce re ng 
‘copes iosnetatee loop control code for WHILE. | 
TcONBaR eenecase triples to test upper limit control expression. | 
oe |Moves text from DO stack to output. ! 
eee iiseee input text to DO stack. ! 
ee teaye up control variable text in DO block. ! 
 pieenn |Chains dictionary entries. | 
proce |Makes a dictionary entry. 
Lae (Li) ere expression to determine result type. | 
eee {Initializes phase. 
‘ea0002 feeahe text. | 
ee00i6 on EOP triple encountered, releases scratch storage and passes 
{ |control to next phase. | 
ood ee iterative DO triples pushes down stack and examines control 
| | variable. | 
eee ise iterative DO‘ and DO* triples pushes up stack and removes top 
| jentry. 
ie 0013 |Pusnes down DO stack. ! 
2 G0015 a CV triples reverts to normal scan. | 
| 0027 \ For TO and TO' triples, examines argument and assigns to temporary 
| Jif necessary. | 
ais For RY and BY' triples, examines expression and determines sign of | 
| j{constants. Assigns variables to temporary. | 
ize 30021 oo WHILE and WHILE triples, marks loop as iterative and generates 
| {text triples. | 
eee ‘anes WHILE triple encountered, branches to generate comparison 
| |triples. | 
ferrer |For DO EQUALS triples, assigns expression to a temporary: generates | 
| |code to control loop if at the end of specification. | 
eee |Moves triples to output. ! 
‘iauaae ore one triple to output. 
SEGUE |Removes item from DO stack. 
ips SHDWN |Pushes down DO stack and initializes new stack entry. | 
 eavooy serve wave pseudo-variable argument type. 
ToaCEE nana DO stack text markers. | 
[nEsTOP a expression result type and assigns to temporary if not | 
L J 


ca a a ae ee mr ce we a ee hi re ae we ee ne ee ee ee ee ee ee ee ee eee ee ee ee ee eee = 
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-@Table LS. Phase -JI.S- Pseudo-Code Expression Evaluation 


Rr ee a ng ea ee De ne a REM on ee nee an pe ee Ny 


i. |Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
| --~-~— = nnn nnn nnn nnn nnn fn nnn nnn nap a8 == === === === +4 
|Scans text and branches to | LBO |ARITH, FUNCT, LZZ1, MOVEPC, | 
| [processing routines; marks phase LW| |SCAN (KT), STRING, SUBSPT | 
jand releases control to next phase | | | 
{Calculates result type and |ARITH, ARITH2 |ADDSTK, ASSIGN, CONVT, DICDES, | 
{generates pseudo-code for +, -, *, | EXPONT, GENRPD, GETADX, GETFR, 


Joperators, and ADD, MULTIPLY, and | STRING, SWOP 
{DIVIDE functions 


i a re ee ne a a en ee he ee ee ee a ee ee { 


| | 
|7, prefix +, prefix ~, compare | |GETGR, MOVEPC, RELSTK, SETCPX, | 
| | 
{ | 


{Calculates result type for string |STRING |LZ21, MOVEPC, STALRG | 
joperators | | | 
fa ee SE gc ICT SE A ala a 
|Inserts symbolic register in | SUBSPT | ADDSTK, DICDES | 


|subscript triple and stacks result | | | 

|Inserts workspace description in | FUNCT | ADDSTK, ARITH, DICDES, GETFR, ; 
J{TMPD triples after function, and |GETGR, SCAN(KT) 

jstacks result. Stacks arguments 

|for ADD, MULTIPLY, and DIVIDE 

{functions. Adds pseudo-variable 

[markers to stack 


ame ame eee come eee anfee come cane ome comme 


| 

| 

| 

I | 

| | 

i | 

~---------------------- == }---------------}-------- -- -- ---- == --- === + --------4 
[Calculates results types and | EXPONT ADDSTK, ARITH2, CONVT, GETADX | 
|generates pseudo-code for ** | MOVEPC, STALRG, SWOP | 
jOperator. Generates calling | | 
|sequences to library subroutines | | 
| for complex arithmetic | | 
---------—--------------=-------—- }~--~----~------}----------------------------------+ 
|Calculates target type and | CONVT | ADDSTK, ASSIGN, GETFR, MOVEPC, | 
|generates assignment triple for | | STALRG | 
|conversion; sets dictionary entries| I | 
{for constants | | | 
-~----------------~----------------- $--—------------ 4----------------------------------- { 
jInterchanges operands; optionally |SWOP |GETADX, GETFR, GETGR | 
Jloads first operand | | { 
ma nn a nn nf nnn nnn nn nn nn nnn rn nnn 
|Obtains free floating or fixed |GETFR. GETGR |GETADX, STALRG | 
Jarithmetic register; stores it, if | | | 
|necessary | | ] 
}-------------------------—--------- }--------------- }--~---~---------------- ~----------- 4 
jAdds items to, and releases items |ADDSTK, RELSTK | None | 
| from intermediate result stack | | | 
~---------------------------------- $---------------}-----------------------------------+| 
{Generates calling sequence for | SETCPX J EXPONT, GETADX | 
|complex * and / operators, | | | 
jsupervises complex arithmetic | | | 
p----———-- = == -- + - = = == fn nnn enn nnn nnn nnn nnn nn nn nnn nnn 
J} |Inserts TMPD triples after zero {L221 |RELSTK, SCAN(KT) | 
| operands | | | 
boo tae at dae eee oa ee be Seek eee Ea (ene ec ne ne ore ep pn NET ee J 
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pues LS1. Phase LS oe Directory 


JADDSTK (LT) 


ASSIGN 
COWST 
Cc 


ONVT 


| 
i 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| DICDES 

| 

| EOP2 

| 
|FXPONT (LU) 
| 
| 
1 
| 


FCTDES 


FUNCT 


FxC1 (LT) 
GENRPD 
ETADX (LT) 


G 
GETFR/GEIGR (LT) 


| 
ARITH/ARITH2 (LT) 


i 

| 

| 

| 

| 

| 

| 

| 

! 

| 

| 

| 

| 

| 

| 

{| LBO 

| 

|LBE21 (LT) |Tests for operand conversions and constants. 

| is 

{LBFL1 (LT) {Generates floating pseudo-code. 

| 

{L221 {Inserts TMPD triples after zero operands. 

| | 

| MOVEPC |Moves pseudo-code to output text. 

| 

| PSI. {Adds pseudo-variable marker to stack. 

| . . 

{RELSTK (LT) jReleases items from SRR CEMe SSeS result stack. 

| | 

{SETCPX (LU) |Generates calling sequence for complex * and / Operators: supervises 
| jcomplex arithmetic. 

| 

| STALRG {Generates pseudo-code to store all arithmetic registers currently in 
| juse. 

{ 

| STRING | Calculates result types for string operators. 

{ 

| SUBSPT |Iinserts symbolic register in subscript triple and puts result in 
| | stack. 

| 

| SWoP jInterchanges operands and optionally loads first operand. 
Oe a Sr a a eee 3 


jadds items to intermediate result stack. 


{Calculate result type and generate code for +, -, *, /, prefix +, 


|prefix -, compare operators, and ADD, MULTIPLY, and DIVIDE 
| functions. 


mee ee ee ee ee coe eee ade ome ond 


{Generates an assignment triple and TMPD in the output text. 
|Sets up dictionary entry for constant operand. 


|Calculates target type and generates assignment triple for 
| conversion. 


[Constructs operand description from dictionary entry. 
|Marks phases wanted/not wanted and releases control. 


{Calculates result type and generates pseudo-code for ** operator, 
Jand generates calling sequence to Library subroutines for complex 
arithmetic. 


| Inserts workspace description in TMPD triples after function, and 
{stacks result. 


{Inserts workspace description in TMPD triples after function, and 
|stacks. result. Stacks arguments for ADD, MULTIPLY, and DIVIDE 
|functions. Adds pseudo-variable markers to stack. 


|Generates fixed binary pseudo-code. 


{Generates pseudo-code for packed decimal operations. 


|Sets up address of pseudo-code instruction. 


{Obtain free floating or fixed arithmetic register; store it, if 
|necessary. 


|Scans text and branches to processing routines. 
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@Table LV. Phase LV Pseudo-Code String Utilities 


CO er ee ee ae oe at ar es et re ne 1 
| |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
Se Sr a St Sa ee ee see eae | 
[Initializes module; releases | STRUTO | None | 
[control to next module | | | 
}---------—------------—----------- }--—------------ }~--------- -------------------------- { 

| |Converts data item to string; | STRUT1 {SCAN (KT), STRUT2 | 
{calculates string length | | | 
}------------—---------- —-----------} --—------------} ----- = - ---- == === === 
|Prcduces a string dope vector | STROT2 | None | 
jdescription from a standard string | | | 
| description | | | 
Table LV1i. Phase LV Routine/Subroutine Directory 
ee en re Se ee ee ee ee eee 
| Routine/Subroutine | Function | 
AS AS A SS A A TS eS LY AS A ce a ae a ES eee ee ee ee ee ee ee eo ee are om oe ere oe oe oe Oe ee ees eee ee —-------4 
{LSUT17 jTests whether string length is greater than 256, and if necessary | 
| . |generates fixed length calling sequence. | 

| 

| LSUT22 {Tests whether string dope vector result is required. | 
| | 

| LSUT26 {Generates any assignment and TMPD triples. | 
| 

| LSUT27 |Sets up assignment and TMPD triples. | 
| 

| STUTO | Initializes module; releases control to next module. | 
| | 
{| STRUT1 |Converts data item to string type; calculates string length. | 
i { 7 | 
| STRUT2 |Produces string dope vector description from standard string | 
| | description. | 
| | | 
{| ZSTUT1 |Txansfer vector to STRUT1. | 
| | 
| ZSTUT2 | Transfer vector to STRUT2. | 
J 


| Pee ees es cee ere wes we wee wee Ne cen ene wee ee ee ce ne cee ee ee coe ee a wee ene en ene ee Ce a AS a ES Ew EE ae ea ee ee a a eee oe o> oe oe a ee ow oe eee 
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@Table LX. Phase LX Pseudo-Code String Handling 


Ee ee ae ea a a ee ee em ee SE ie ee ge 1 
|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
Oo err nnn nnn nnn nnn nnn nnn nnn fen nnn nnn nn nn nf nnn nnn nnn nn nnn nnn 
| |Initializes phase, scans text and |BEGIN | FUNPT, SCAN (KT), STROP, | 
{branches to processing routines; | |SUBSPT, TMPDT | 
{releases control to next phase | | | 
| | Processes TMPD triples. Arithmetic|TMPDT |GETMPD, MOVSEL, RELSTK, SCAN (KT) 
|jtype TMPDs are ignored. String | | SETMPD 


| 
|TMPDs are replaced by the top item | | | 
{from the string stack | | 
4 
| Processes function and function | FUNT |ADDSTK, DICDES, GETADS, GETMPD, 
| Jargument triples. Arithmetic type | |MOVEPC, RELSTK, SCAN (KT), SETMPD, 
{functions are ignored. Dictionary | | STROP 
jJentries are created for the results| 
Jof string type functions. A | 
jlibrary calling sequence is | | 
|generated for the BOOL function | 
Jusing the mechanism for packed bit | 
|cperations. The result | 
| descriptions are added to the | 
|string stack | 
| ---------—-------------------------}---------------} -----------~----------------------- 
| |Processes subscript triples. | SUBSPT {| ADDSTK, DICDES, SBGNOR, SCAN (KT) 
|Arithmetic type subscripts are | 
jignored. A symbolic register or | 
jworkspace offset is added to string| 
jtype subscript tripnles and the 
jstring description is added to the | 
jstring stack | 
a a a ee A —~~--~~----~--} --- -- + - + - -- ++ - 5-5 + +--+ 
| Processes string operations CONCAT, |STROP |ADDSTK, DICDES, GETADS, GETADX, 
JAND, OR, NOT and comparisons with | |GETMPD, MOVEPC, MOVSEL, RELSTK, 
| |stxing type operands. For simple | | SCAN(KT), STRUT(LV), ASSIGN, 
jcases, in-line pseudo-code is | |GETWS4, GETWS8, SBGNER, SEGNR 
|generated; otherwise calling | 
[sequences to the library are | 
[ 
| 
4. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
i 


|generated. The results are added 


ah Se oe oe ee 
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“Table LX1. Phase LX Rout ine/Subroutine Directory 


| Routine/Subrout ine] ; Function 


ann nn nnn nnn fn nn nnn nnn nnn nan nanan nnn nn nnn nnn nnn nnn nf 


| ADDSTK 


{ 

eee (LY) [Constructs dope vector and string descriptions from a given 

| {descriptor which may describe either a string, or its dope vector. 
— [Generates an assignment triple and associated TMPDs in the output 
| [text. 

| BEGIN {Main controlling routine for phase. 

ee |Constructs operand description from dictionary entry. 

panes {Processes result returned by functions. 

= peice funtion and function argument triples. 

l eenpey ceria jConstruct address part of pseudo-code instruction. 

| GETMPD {Constructs operand description from TMPD triples. 

leew taiieesite 4 bytes of aligned workspace. 

\cerwse iAlieesese 8 bytes of aligned workspace. 

rie jTerminates phase at end of progran. 

ae ragadeaeme Library calls for string operations. 

ae (LY) aetieatecs pseudo-code for NOT operation. 

vais (LY) | Generates pseudo-code for concatenation operation. 

eae (LY) {Generates pseudo-code for comparison operation. 

teas (LY) ere pseudo-code for AND/OR operation. . 

ern |Generates pseudo-code to convert to string. 

1 OuRES |Moves pseudo-code from buffer to output text. 

‘ioseer tiove SELL triples to output text. 

| aucaever Ge) |Creates MVC instructions. 

taaeaee | |Removes strings from the intermediate string result stack. 

| SBGNER roses next evenvoad pals of symbolic registers. 

| aeeNOn lasts next symbolic register. 

\gaciee lasts next symbolic register. 

‘opiNeD {Constructs TMPD triples from description. 

 emoe | Processes string operations CONCAT, AND, OR, NOT, and pompets sons 
| jwith string type operands. 

fender {Processes subscript triples. 

| clipes |Processes TMPD triples. 

las [sets flags for triple types. 

Dc ee ee ee er en a re ee en re ee eS ee eee 
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|Adds strings to the intermediate string result stack. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
l 
| 
[ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
4 


®Table MA. Phase MA Pseudo-code Translate and Verify Functions 


“tT 
]Main Processing| | 
| Statement or Operation Type {| Routine | Subroutines Used | 


+ + 
|Scans source text _  |Phase KT (SCAN) |SC1 (KT) { 
Susu PS ScudauhyapupUnEP UP Tae DueunP =Teo=S URRERERENETEnES Sotsteetaimneietenenanimens beet eemmapspenpeenaremnennetetantaiatmmetatmet | 
{Function marker triple (FNC) | FUNC |SC2(KT), SC3(KT), SCS(KT) 1 
| processor | | | 


w-~--—---------------- ~~ ------—} === -- +=“ == 22-2 = === === == === === -- +f 


{Double coma triple (FNCM) processor|SDCOM. |SC2(KT), SC3(KT), SC5S(KT) | 


+ 
{Function prime triple (FNC') | SFNPM . {SCS(KT) | 
| processor | . | | 


+ -+- 
jCreates compile time table . |Ttvii -— |TV13A, TV31A | 
}---------—--------—------------—--}-------------+} -----------------------------------4 
{Converts constant from internal to |TV13A | None | 
jexternal form and vice versa | | | 
naan enn = 5 a fo $f nn 8 
jInitializes VERIFY compile time |TV15A nd | TV13A rr | 
| table | | { 


~---~---——-------—-----—----- f= ~~ =~ =f nnn 


|VERIFY function floating table | TV1L7A | MV3 (KT) | 
| build | . | | 


i a a ac a ca anc cw em a i ea a ac a cc cae a es -----~------ --- - - - - + --- - - - - -- - ---- | 


|Pseudo-code build for VERIFY {TV18A {MV3(KT) | 
| function . | | | 
~~-~~------- =~ -- = -- == == == = 
{Floating table build for TRANSLATE |TV21A | MV3 (KT) | 
me ee en nn on fh nn ne nn en ff we 3 He nn en nn ef 
| TRANSLATE function in line code |TV22A [MV3 (KT) | | 
~--------+-- -—- ---- —— -- —- ----- + } +--+} --- -- -- - = +--+ - - = =] 
{VERIFY function processor | | TV24A - |Tvli, TV31A_ - | 
mn nn nnn fn rn nf ci nn nnn nnn nnd 
{Tests for duplicate character _ | PTTRAN | ERROR ; | 
| constant ot | : 1 0 | 
wana aan nn a nf nan nna nnn nnn nnn nnn nnn nnn 


[Floating table search “[TV31A | None | 


F + + 

|Library calling sequence generator |TV35A |MV3 (KT), TEMPW | 
wanna nan naan nn a= foe fp on 
{Updates function dictionary |TV38A | None | 
jxreference | | | 
~---—-------——~---- ---- -- == = = ff en nnn 
Jobtains workspace islets | None | 
ere ee aS Sa a aS ya eee ee ee rnp eR Pe Ne ee NP Ie Sa ee J 
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@®Table MA1. Phase MA kRoutine/Subroutine Directory 


[Routine/Subroutine| = = |. Function 1 
moe " ° (nee caemsnce 
rou peeteaee function marker triple (FNC) 
oe |Tests for duplicate character constant ! 
oe i peseeiaes double coma triple (FNCM) 
repant {Processes function prime triple (FNC') 
Reuven jObtains workspace ! 
net |Gets temporary workspace ! 
een {Processes TRANSLATE function | 
er jCreates compile time table 
en Neenweras constant from internal to external form and vice versa | 
{2V15A eer rrr eee VERIFY compile time table 
Caer weitas VERIFY function floating table | 
err Veutiie pseudo-code for VERIFY function 
| voLA | nai dée floating table for TRANSLATE ! 
}TV22a {TRANSLATE function in line code 
| av2ua | Processes VERIFY function 
eaaa ecaveaes for floating table 
| V35A \canepsees library calling sequence 
|v3e0 [Dpaates function Cictionary reference ; 
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@®Table MB. Phase MB Pseudo-code Pseudo-Variables 
i aaa aR a Sa Ta, mS a aR a a a a a 


| |Main Processing| | 


jJentry and aenerates code for data | 
{list items | | 
}-----------------------------------}--—-----------} ----------------=------------------4 
{Assign completes stack and rescans |MB0013 |DRFTMP, MMV3A5, MVTMPD, OUTMPD, | 
|group of assignments, putting | | TARGET 
[target descriptions out in correct | 
|sequence; generates code for | 
jpseudo-variables in stack | 

+ 


| Statement or Operation Type | Routine | Subroutines Used | 
~------------------—---------------} --------------- }-----------------------------------4 
] {Scans souxce text |MBOOOLT |sci (KT) | 
wn nnn rr fron nnn fan nnn aan enna nnn nnacand 
{PSI operator; starts new entry in [|M30011 | SWITCH | 
|stack for pseudo-variable | | | 
oo + = f-2---------- +} o-oo ne nnn nnn 
|PSI* operator; completes stack |MB0012 | SWITCH, TARGET 
| 
| 


| 

| 
~---~----------~-------------------}--------------- }----------------------------------- { 
{Multiple assign; places only target|MB0014 | MVTMPD | 
{descriptors in stack | | 
~--------—-~----~-----=-----------—- $~------~-------} -~-------- === == == --- === -- === | 
{Constructs pseudo-variable stack | MB0020 | MVI'MPD | 
jentry | | 
}---------—------------—----------- $--------------- }---~----+---—- -------------------- { 
{Places temporary descriptor in | OUTMPD | MMV 3A5 | 
J output | | | 
nan 3 a nnn nnn af nnn nnn nn nan nn nn nnn nnn nnn nnd 
{Gets temporary workspace for | TARGET | GETWKS | 
jeseudo-variable, if necessary | | | 
Pe ees eas ee ee teers bBo eewe eee ae 1 a ee ee nar me Re ee ee re ae ee Ee 4 
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Table MB1. 


[Routine/Subroutine|+==~=~=~~~~~~~”~SC~C«<~YNeL/[N.SSOSSCSC~CS<SstStS«*Y 
jpReEee, [en “Cancaraey descriptor <con. a diccionary cacerences 7 
os |Obtains workspace to accommodate a variable of given type. 
porn tesane source text. 
e008 |Multi-switch for triples of interest. | 
00ud on reaching end-of-text marker, releases remaining block, and 
| {releases control of phase. | 
mpooud {PSI operator; starts new entry in stack for pseudo-variable. ! 
frre {PSI* operator; completes stack entry and generates code for data 
| {list items. { 
ere’ | ASSIGN; completes stack and rescans group of assignments, putting 
| jtarget descriptions out in correct sequence, generates code for | 
| |pseudo-variable in stack. | 
rao imeieapie ASSIGN; places any target descriptors in stack. | 
| 10020 {Constructs pseudo-variable stack entry. 
meiaio [Resets input pointer to start of sequence of ASSIGNS. ! 
ere inenetus ASSIGNS and associated TMPDS from stack in reverse order. 
free [Tests for end of stack. ! 
piaie aaeee for pseudo-varaible TMPD. 
mass Neeseeauee code for pseudo-variable. 
seer |Moves one triple to output. 
eR [Places temporary descriptor in stack. 
‘arias [Places temporary descriptor in output string. | 
Guiness jChanges scanning table. | 
[TARGET [obtains temporary workspace for pseudo-variable, if necessary. 
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Phase MB Routine/Subroutine Directory 


@Table MD. Phase MD Pseudo-Code In-Line Functions 


|Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
| |Scans text |Phase’ KT (SCAN) | None | 
|--------------------------------- ~~ === =f on 58 nn nnn nnn nnn nnn 
|Builds up function stack | LFARIN | None | 
ceca si cn Sa a tha i as casa coe a Acme lan ie es oN oe ee a i See aera j 
{Builds up argument stack | LFCOM | None { 
mann nn = nnn ann nnn nnn nna enna a nnn nn nf 
| |Moves generated code to output | LFMOVE | MV3 (KT) | 
| block | | | 
|--------------------~------------—-}---------------} -----------------------------------4 
|Generates in-line code and | LFEOF 2 | SNAKE , ROPE | 


library calling sequences | | | 


Table MP1. Phase MD Routine/Subroutine Directory 


et see a >T ee or ee rr ee ee a ee ee ee ee ee a ee a ee ee re 8 a ee ee et wre et ee es ee oe 


|LFART1 continues scan for in-line functions. | 
_ | LFARIN inate up function stack. 
| LFCOM ere up argument stack. 
| LFGR , |Unpacks dictionary reference of argument when argument triple ee 
| LFEOF2 icalls subroutines to generate in-line code. | 
| LFIGN causes triple from text if inside an in-line function. ! 
iveese sae if IGNORE triple or not an in-line function. 
a Weecewsies code for STRING function. 
| SNAKE ideneenece code for ADDR function. 
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eTable ME. Phase ME Pseudo-Code In-Line Functions 


|character or aligned bit string, the second argument is constant and 
{the third variable. 


Sa a a a a ae eR a aaa a aman a ar | 
| : {Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
~----------------------—---------- }-----~---------}-----------------------------------4 

| |Scans and moves text {Phase KT (SCAN) {|SC1,SC2,SC3,SC5,MV3 | 
wor ee oo ee oe ee ee a © 2 we eo oe Oe oe ee oe oe = oe 
|Builds up function stack | SFUNC | ZDRAOF : 
}--------------------~------------— $--—~----------- }--~-~-------~----------------------- { 
|Constructs result TDB and branches |SFNPM |MS4,MS5,MSB, RTAA, RTAB, INDEX, | 
jto routines for INDEX, UNSPEC, | | ILUNSP, EVENT, ZDRAOF , STATUS | 
|COMPLETION, and STATUS | | | 
mann nn nnn nnn af nn nn nnn nn nf nnn nnn nnn nnn nnn nnd 
{Deletes current triple |SIGN | None | 
pom nnn nn nnn nnn fn nnn nnn formar nnn nnn nnn nnn nnn nnn { 
{Builds up argument stack | SDCOM ; | ZDRAOF | 
}-----------------------—--------—}---------------} ------~----------------------------| 
{Inspects arguments and branches to |MSB | RTB, RTC, RTD, RTE, RTF,RTG, RTH | 
jappropriate subroutine | | | 
hae ee eee eee eee eee a Sa aia a asin lela eae a J 

Table ME1. Phase ME Routine/Subroutine Directory 
Sag cam A mR a aa a a a a ae a | 
| Routine/Subroutine | Function | 
}------------------ }} ---------- --—- --- == - = - == - << = nnn nnn nnn nnn nnn 
| EVENT |Generates in-line code for COMPLETION function. { 
| | | 
| | I 
| FINISH {Passes control to the next phase. | 

l | 
| ILUNSP |Generates in-line code for the UNSPEC function. | 
| 
| INDEX |Generates in-line code for optimizable invocations of the function | 
| | INDEX. | 
| | 
[MS |Calls subroutines to generate in-line code. | 
| ; 
| MSG |Resets current flag and continues scan. 
I 
| RLCTOF |Releases module and passes to next phase. 
{ | 
| RTAA {Generates in-line code when the result is in a register by name, and 
i {the second argument is constant. 
| | 
| RTAP |Generates in-line code when the result is in a register by name, and 
| {the second argument is variable. 
| 
| RTB {Generates in-line code for the case when the first argument is an 
| Jaligned bit string, and the second and third arguments are both 
| | constant. 
[RTC jGenerates in-line code in the case when the first argument isa 
| 
| 
i 
| 
| 
| 
{ 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
\ 
| 
B | 


RTD |Generates in-line code when the first argument is a character or 
jaligned bit string, the second is constant and the third is not 
| present. 

RTE |Generates in-line code when the first argument is a packed bit 

| jstring, and the second is constant. 

| | 

| RTF jGenerates in-line code when the first argument is a character 

| Jstring, and the second and third are both variable. 

do ee be en ne ene 
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Table ME1. Phase ME Routine/Subroutine Directory (continued) 


jRoutine/Subroutine| | | Function 4 
mec © eenee acca anak tne codesunen the Fike stcmae io a cuseetas 
| |string, the second is variable, and the third is not present. | 
oa \osaedoeee in-line code when the first argument is a bit string, and 
| {the second is variable. | 
ee |Exror routine. 
; SiGhER {Gets the next even register and sets the even/odd bit on. | 
1 anawon |Gets the next odd register and set= ‘he even/odd bit on. | 
fee |Gets the next available symbolic unassigned register. ! 
eee {Scans for the next triple of interest. 
| chu ipeeeinuiees pointers and text blocks. | 
\eneon |Builds up argument stack. 
\Sepn j|Generates in-line code. 
ieeouc {Builds up function stack. | 
ieee (Deletes current triple. 
i crane fnnoree code for STATUS function. 
poe {Constructs a string dope vector. 
eon ieopeeiees code to place the address of the first argument plus a 
| {literal offset into a symbolic register. | 
ee Perenee a ST and DROP instruction, optionally followed by a MVI 
| jinstruction. | 
‘Aue ieonaeeaes a dictionary entry for the constant JJ, and generates an 
| |Mvc instruction. | 
rouns {Generates two STH instructions, followed by a DROP instruction. 
reode {Generates an RX instruction to operate on a TDB by a register, ! 
| joptionally followed.by an instruction to drop any register used in | 
| {addressing the TDB item. | 
raueit leduwestee SR, SLDL, OR instructions. 
re |Generates SR, SRDL, OR and DROP instructions. ! 
ao {Calculates correct values for ILEN, IOFF and Y. | 
eee |Converts a dictionary reference to an absolute address. | 
edeeas aeren scratch core. 
a a ans a a aa re ys eae el i ee a ee el 
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- @ Table MG. Phase MG Pseudo-Code In-Line Functions 1 


Spe er age ee ee gee oe ee Gea Mr a eT e eee es ee ee es ae rn eS a 
|Main Processing} | 
| Statement or Operation Type | Routine \ Subroutines Used | 
bmn nnn nnn hin nnn mn nap nr nnn nn a nnn nnn nnn nnn ann nnn 
{Scans text [PHASE KT (SCAN) {None | 
[Jaana a nnn nnn nnn nn nnn nnn nnn nn finn nnn nnn mn nen nnn nen nen nnnn anand 
{Builds up function stack | LFARIN | None | 
A AES AS A A A A SS TS A eS OE Se SS A TS a Se AS I Tes wo +f oe oe oe ee Om ee > > re re ee ee ee ee oe ee ee ee ee ee ee ee ee ow ee oe | 
[Builds up argument stack | LFCOM | None | 
ferrari nnn fon nn nnn nn nnn na - { 
|Move generated code to output | LFMOVE |Mv3 (KT) | 
| block. | | | 
na === === 2 fof on = === += == === 2 === == +4 
{Generates in-line code | LFEOF2 |ABBFLL, ABBFLS, ABSFB, ABSFD, 


|ALLOC2, CEILB, CEILD, CEILL, 

r |CEILS, CMPLXB, CMPLXD, CMPLXL, 
| |CNASTR, CNVINT, CONJGB, CONJGD, 
| |CONJGL, CONJGS, ERRFUN, FLOORB, 
| | FLOORD, FLOORL, FLOORS, IMAGB, 
| | IMAGFD, IMAGL, IMAGS, REALB, 

| |REALFD, REALL, REALS, SBGTNR, 

| | TRUNCB, TRUNCD, TRUNCL, TRUNCS, 
| |UNSPEC, UTTEMP 

a5 


[fo wee ee ee ee ee ee oe oe 
ee cs ees me cee cere SD comes SE cee Se 


OE AS A OT ES ES SE SS ES ES SY SS DD GE EY SD YY SES DG ES ER AD A ee ee ee tee ly a cee Ge le eee Se ee ee ED a aS ce aon A SRT ME cae GS AO mS NS MeN SEE ES EDS Ae AY EE OR em mae Ss a Am ee EP os ee PO ds ee ne | 
Table MG1. Phase MG Routine/Subroutine Directory 
ae ne ee SU re res ete ae eR Te ge a oe Pe ee TT ar ee a ae ee 1 
|Routine/Subroutine | Function | 
nnn nn ann nn rr eed 
| ABBFLL [Generates in-line code for ABS function with long floating-point | 
| jargument. | 
I | : | 
| ABBFLS |Generates in-line code for ABS function with short floating-point | 
| | argument. i 
| | 
jABSFB {Generates in-line code for ABS function with fixed binary argument. | 
1 | 
[ABSFD {Generates in-line code for ABS function with fixed decimal argument. | 
| | | 
| ALLOC2 {Generates in-line code for ALLOCATION function. | 
| 7 { 
{CEILB (MH) jGenerates in-line code for the CEIL function with fixed binary | 
| | argument. | 
| | 
|CEILD (MH) {Generates in-line code for the CEIL function with fixed decimal { 
| | argument. | 
| | 
|CEILL (Md) |Generates in-line code for CEiL function with long floating-point | 
| | argument. | 
| | 
|CEILS (MH) |Generates in-1ine cuue for the CEIL function with short | 
| | floating-point argument. | 
| | | 
| CMPLXB {Generates in-line code for COMPLEX function with fixed binary | 
| | argument. | 
| | ; ; | 
| CMPLXD {Generates in-line code for COMPLEX function with fixed decimal | 
| jargument. | 
| | festa cae sci 
| CMPLXL |Generates in-line code for COMPLEX function with long floating-point | 
| | argument. 
| : 
| CNASTR jConstructs assignment triple and associated TMPDS. | 
. | 
{ CNVINT {Converts a decimal integer constant to fixed binary. | 
ate ta rian Derwent an ee re ea en ee a a ne een 


Table MG1. 


LE LS ES A SS A SS SS IS SS ES SD ED ES ce SS SD SY SUS Se ES ED Ge ee GE Gl ee om ee ey Ge ee oe ee oe ee ree er ae OS OO ee @ we ew ee wee 2 


|Routine/Subroutine| 


| CONJGB 
1 
| CONJGD 
| 
CONJGL 


CONJGS 


ERRFUN 


FLOORS 
FLOORD 
| FLOORL 
FLOORS 


IMAGB 


| 
I 
| 
| 
1 
| 
| 
JE 
| 
{ 
| 
I 
| 
| 
| 
| 
| 
| 
| 
| 
| 
\I 
| 
| IMAGFD 
| 

| 

{ 

| 

| 

| 


| LFIGN 


L 
LFSPEC 
R 


| 
| 
i 
| 
| 
| 
1 
| 
| REALB 
t 


(MH) 


(Md) 


(Mi) 


(Mia) 


Phase MG Routine/Subroutine Directory (cont'd) 


Function 
{Generates code for the CONJG function with fixed binary arguments. 


{Generates in-line code for the CONJG function with fixed decimal 
jarguments. 

| 

|Generates in-line code for the CONJG function with long 

| floating-point arguments. 


|Generates in-line code for the CONJG function with short 
| floating-point arguments. 
| 


|Aborts if Phase IM discovers an error in a function. 


|Generates in-line code for the FLOOR function with fixed binary 
| argument. 

| 

|Generates in-line code for the FLOOR function with fixed decimal 
| argument. 

| 

{Generates in-line code for the FLOOR function with long 

| floating-point argument. 

| 

{Generates in-line code for the FLOOR function with short 

| floating-point argument. 


|Generates in-line code for IMAG function with fixed binary argument. 


| 
|Generates in-line code for IMAG function with fixed decimal 
| argument. 


| 
|Generates in-line code for IMAG function with long floating-point 
| argument. 


| 
|Generates in-line code for IMAG function with short floating-point 
|argument. ; 


{Builds up function stack. 
{Continues scan for in-line functions. 


{Builds up argument stack. 


|Unpacks dictionary reference of argument when argument triple found. 


|Calls subroutines to generate in-line code. 

|Depending on start of argument list, branches to produce in-line 
| code. 

iieeoves triple from text if inside an in-line function. 

|Moves generated code to output block. 


{Branches if IGNORE triple or not an in-line function. 


{Generates in-line code for REAL function with fixed binary argument. 
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Table MG1. Phase MG Routine/Subroutine Directory (cont'd) 


TRUNCL (MH) 


TRUNCS (MH) 


@¢ 8 @ 8 4g —_ = 
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j argument. 


{Generates in-line code for the TRUNC function 
| floating-point arguments. 


|Generates in-line code for the TRUNC function 
| floating-point argument. 


with long 


with short 


{Generates in-line code for the UNSPEC function. 


{Gets a required amount of temporary work space. 


aaa aera citi eo ra rales Mp ee ee ey eg eee eee ee aa ag Oe coe ee 1 
| Routine/Subroutine| Function | 
ane rea emcee ans a ea a alae aa a ec ch a sma sire { 
| REALFD {Generate in-line code for REAL function with fixed decimal argument. 
“| .t | 
| REALL {Generate in-line code for REAL function with long floating-noint 
{ argument. 
| 
REALS {Generates in-line code for REAL function with short floating-point 
jargument. 
SBGTNR |Get next available symbolic register. 
TRUNCB (MH) |Generates in-line code for the function TRUNC with fixed binary 
jargument. 
(MH) {Generates in-line code for the TRUNC function with fixed decimal 


bes 


@®Table MI. Phase MI Pseudo-Code In-Line Functions 2 


Se re ei a ae rE Pere te ae et a ar ee ge ee ee ee ey 

|Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
| ~----------------------—----------}---------------}-----------------------------------4 
{Scans text | PHASE KT (SCAN) | None | 
}---------—---------—--—-----------}------------~--4----------—------------------------| 
{Builds up function stack | LFARIN | None | 
~--------—------------------------ ¢--------------- }----------------------------------- : 
{Builds up argument stack | LFCOM | None | 
banana an nn sn nnn nnn nanan nn nn nnn nnn nnn rn nnn nnn nnn nnn nef 
{Move generated code to output block| LFMOVE |Mv3 (KT) | 
LD A AS A A SA A SE SS A A A A AS SS Te SS A TS eae eS a a ee  — — -— f - —_— or ee re ee ee ae em ce ee we ee ee ee wre ee ee oe 
|Generates in-line code | LFEOF2 |MAXB, MAXD, MAXL, MAXS, MINB, MIND, | 


| | |MINL, MINS, MODB, MODD, MODL, MODS, | 
| | |ROUNDB, ROUNDD, ROUNDL, ROUNDS | 


Ge ae ee a ee ee he ee ee ee ee ee ee i SE SD eS ES NS ES ED EE EY CD ES ED Ge ED ED ED ED ee ee ee eee ee ee et eee ee ee ee ee d 


Table MI1. Phase MI Routine/Subroutine Directory 


i . re ee ee ee 1 
{Routine/Subroutine| Function | 
oe a oe ee eee ae en ee en ee eee ae A YE SS A A A SS A AS A OS SS PS A SE A SS SE SE DS A Se a EE SES ED ES ES Ge GS ES EY ee et ee ------~-J 

| LFARIN |Builds up function stack. | 
i { | 
{ LFCOM {Builds up argument stack. | 
| 

| LFEOF2 |Calls subroutines to generate in-line code. | 
\ | 
| LFMOVE {Moves generated code to output block. | 
| 

{MAXB/MINB (MJ) {Generate code for MAX/MIN function with fixed binary arguments. | 
| 

{|MAXD/MIND (MJ) |Generate in-line code for MAX/MIN function with fixed decimal { 
j {arguments. | 
| | 
{MAXL/MINL (MJ) {Generate in-line code for MAX/MIN function with long floating-point | 
| jarguments. 
| | | 
|MAXS/MINS (MJ) |Generate in-line code for MAX/MIN function with short floating-point | 
| | arguments. | 
| | 
JMODR (MJ) {Generates in-line code for MOD function with fixed binary arguments. | 
| \ 
|MODD (Ma) {Generates in-line code for MOD function with fixed decimal | 
| | arguments. | 
{ | 
{MODL (MJ) {Generates in-line code for MOD function with long floating-point | 
| | arguments. | 
| | 
}MODS (MJ) |Generates in-line code for MOD function with short floating-point | 
1 jarguments. | 
{ | | 
| ROUNDB |Generate in-line code for ROUND function with fixed binary argument. | 
{ | | 
] ROUNDD {Generates in-line code for ROUND function with fixed decimal | 
| | arqument. | 
| . | 
| ROUNDL {Generate in-line code for ROUND function with long floating-point | 
| | arguments. | 
| | | 
| ROUNDS |Generate in-line code for ROUND function with short floating-point | 
{ jarguments. | 
L ] 


a a a a a cn ca emt a ch as nse ei coms ce Se ca cs sccm cas tls ee Sm ces tac nen ose ese ce ce es a snes ein ios ce es Sas aed esc mm ic 
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® Table MK. Phase MK Pseudo-Code In-Line Functions 3 


Gye ge ea a en Se eg ey ee NS ae ee 


| | Main Processing] #8 4 
| Statement or Operation Type | Routine | Subroutines Used | 
||scans text ~~ ~SCO™*C*«“‘«*“‘*‘*‘;*Y@SHASE: KT MSCANDNONE™™~™~™~™~SC~C~C~C~C<C<;( ST 
ids piece caer ~~ ene 
feulldoiprergumenvietacr. °° urcon” lees 
i luoee Generated code to'cutsa: Mlogk|iras = SC Ima ae SCC 
\Genarates in-line code ~~~*{LFEOF2. ~~ ~~-*«(DIM, HBOUND, LBOUND, LENGT, SIGNFB)| 


| | |SIGNFD, SIGNL, SIGNS, FREBIF | 


We ca a re wee ae are ac ce me em ce eee ee ee ee a hs a re a se eee ee ne ee ee ce ee ee oe ae eee ae ae es we ee ee 4 


Table MK1. Phase MK Routine/Subroutine Directory 


Cee NP eee Ea Ng en fe EP RACE aT Tee ge rig OE eg ay Bs Ge ET me ag Pew AR Re Pee ENE OK Sieg eg Ee 


| Routine/Subroutine| Function | 
oe ee ee eieaaiens 
| FREBIF {Generates code for FREE function. 
| BBOUND Soperree code for HBOUND function. 
| LBOUND lesneeee code for LBOUND function. 
| LENGT Nemaceetas code for LENGTH function. 
lceagey paride up function stack. 
| LFCOM raaives up argument stack. | 
|{ LFEOF2 jCalls subroutines to generate in-line code. ! 
| LFMOVE Neives generated code to output block. 
| SIGNFB Veenezsees code for SIGN function with fixed binary argument. 
| SIGNFD |Generates code for SIGN function with fixed decimal argument. | 
| SIGNL aeetee code for SIGN function with short floating point esumanes| 
[eeeNs |Generates code for SIGN function with short floating point argument. | 
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@Table ML. Phase ML Pseudo-Code Calls and Functions 


|Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
~------~---------------—---------- $---------------}----------—--------------------—- 
| |jScans text {PHASE KT (SCAN) |None | 
}---------—----------------------— +--—----------- }=--------------------------------- 4 
jIdentifies argument of procedure | FPFNAR | None | 
{invocation | | | 
a a a a at ee ceed She ie a adian aya ikea alee ee 4 
{Selects generic built-in function |FPBIF | FPARD1 | 
~---~--~-~~--------—---------------} ----------—---- $-~----------—-------------------—-- 
|Selects PL/I generic entry name | FPGAR | FPARD2, FPARD3, GNSECO | 
Ge eee eee a ec a I a a ee J 
Table ML1. Phase ML Routine/Subroutine Directory 
(oe Re a ag ee ae eg ee re ee eee ee ee 1 
|Routine/Subroutinr | Function | 
~----~+---—- +--+ --} -- +--+ ee. + +--+ +--+] 
| FPAO1 {Scans for next argument. | 
| | | 
| FPARD1 {Obtains parameter descriptions relating to built-in function | 
{ jarguments. | 
| | | 
| FPARD2 |Obtains successive parameter descriptions relating to the entry | 
| {description of a PL/I generic procedure. | 
| | 
| FPARD3 {Obtains and stacks full parameter description of a PL/I generic | 
| | procedure. | 
| | 
| FPBIF {Selects generic built-in functions. | 
| l | 
| FPEPCO {Constructs an entry parameter. | 
{ | 
| FPFNAR {Identifies arguments of procedure invocations. | 
| | | 
| FPGAR {Selects PL/I generic entry name. | 
| | | 
| GNFM2 {Replaces generic reference testing for uniqueness. | 
| | | 
| GNSECO |Makes entry in stack of parameter descriptions. | 
ba ee ek a ee ea a ee ee ee ee eae eee ea 
eTable MM. Phase MM Pseudo-Code Calls and Functions 
(Sere ee ee Sy Nh ag err ee ee eee ee 1 
| {Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
}-----—---------~-------- =~ ---- +--+ =f + nn { 
|] |Scans text ‘| PHASE KT (SCAN) | None | 
{Scans list, counts arguments and | CFCALL |CFARID, CFFBIR, CFFDVS, CFMVTR, | 
Jidentifies storage class | | CFMVCD | 
~---------- +--+ +--+ ---- ++ +f + eh ne en 
|Rescans list and generates calling |CFCFSS |CFARHA, CFCALP, CFBIFH, CFMLBR, | 
{seguence for library routine | |CFMVCD, CFNEST, UTTMPW, CFAIF1, | 
| { | BASED { 
i a a a a al ia a cee aa Ae en a ae ap Se apes ee as 
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Table MM1. 


[Routine/Subroutine| = =. function ~~ SSSOtCSSS 
[BASED (MO) [Generates relocation code for based variables. ~~~ ~—SOSS™S~S 
poe |Initializes phase. 

|CFALF1 (MO) |Places address of invoked routine at the head of its argument list. 
| CPFARHA eanwencea calling sequence. 

leeaeté (MO) leebaks arguments and sets STATIC/AUTO flag. 

| oFBIFH {Further built-in function identification with relevant parameter 

| | setting. 

for |Restores previous environment. 

are {Tests nature of function found. 

ene isesearte pointer to start of invocation. 

eae. j|Scans lists, counts arguments, identifies storage class. 

lceate [Completes calling sequence and, if necessary, generates code to 

| Jinitialize dope vector. 

igaense aoe for nested function. 

Vegeega |Rescans list and generates calling sequence for Library routine. 
opens ewatee vector after first scan. 

Neseage errs built-in functions, sets parameters for calling sequence 
| ] generation. 

ae (MN) aubesees output text area for generation of code to initialize dope 
| | vector when a function returns a string. 

\ernde laenetaces code to set up result dope vector. 

forte hagaeediea code to place result address in argument list. 

aoe (MN) {Generates code to move a skeleton parameter list which is greater 

| [than 256 bytes. 

canes {Generates pseudo-code into the output text block. 

lomaver {Generates triple into the output text block. 

icbaeen |Handles a nested situation. 

| o¥007 teeta parameters to produce special calling sequences. 

| urmMPH (MN) [EL TOCRESe one word of workspace. 
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Phase MM Routine/Subroutine Directory 


fee eee cscs eee memes aman AS em EE NS SEES GOD ED SS SD A NOD SD DD cee NE GAD ND SE GE SS GS SY OD ES cS SE ES ee SS ee SD ee SE ey SE ee ae ee ee ee ee ee oe 


@®Table MP. 


Phase MP Pseudo-Code BUY Reorder 


|Main Processing| 


| Statement or Operation Type | Routine | Subroutines Used 


}--—------—------------------------} ---------------} ------------ = --==-------------+--- 


| [Main scan routine for phase [MP1 aeamtllay ZDRFAB, ZTXTRF, ZUERR 
| en eS a ce eee ee cae es ne ee cee nw ca ce ce ce a ee em ne ees mae nr os een am cae a ee a ee a ee oe ee oe eee ee ee ] 


®Table Mp1. 


(8 8S SS ee Ee ET op On ae oe ee ee es ee ee ee er ee ee ae 


Phase MP Routine/Subroutine Directory 


|Routine/Subroutine| . Function | 
urs  ~«*Y[Adds SELL dictionary reference to SELL list if not already there. | 
faci [Main controlling routine for rearranging BUY and SELL statements | 
| jinvolved in obtaining VDAs for adjustable length string temporaries. | 
iiips eee EOP triple. Releases control of phase. 
| wpe | Processes BUYS triple. ‘ ! 
|MPGA igecebed BUYX triple. 
pe {Continues text scan if not string or arithmetic data, or not ! 
| | structure. | 
apes ‘oontineee scan of text. 
oe eit tas BUYS triple. ! 
| p27 teeeseuiecs BUY ASSIGN triple. ! 
| p28 eerpee BUY triple. ! 
ore eeeenr SUBSCRIPT triple. 
Gea ieueedsens ASSIGN triple. ! 
‘ea racceunes top stack entry. | 
meee {Tests triple for BUYX, and processes. | 
| wpe7 eee for BUYS, BUY, and SELL triples. 
ins | Processes SELL triple. 
( scauaee |General scan routine. 
oseae |Converts dictionary reference to absolute address. ! 
lenserer {Changes absolute address to a text reference. 
i POERE [Wakes error message entries. 
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@Table MS. Phase MS Pseudo-Code Subscripts 
Sere te ee ee a a ee ee 
| |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 


aan anna nnn nn nn nnn nn nnn nn fin nn nnn nin nnn nn nnn nn nnn nnn nnd 


jScans text | SBSCAN | None | 
wa nnn nnn nn af nn nnn nn nn nnn nnn nnn nn nnn nn === 
{Calculates element offset | SBSTIH | SBASS, SBCOBI, SBGNOR, SBMVCD, | 
| | |SBNEST, SBSUBP, SBSUDV, SBXOP, | 
| | | UTTEMP, SBOPT, SBFSUB, UTTMPH | 


|----------------------------------- $--------------- fama nn nnn nnn nn nnn nn nnn 4 
|Checks subscript range | SBSBRN | None 


| 
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@®Table MS1. 


Phase MS Routine/Subroutine Directory 


[Routine/Subroutine]| = || ~~+~+~+~Function =~ Stst=CSsSSC‘CS i 
latass,  « Wepantee sean pointer ofer ai aecigaene. 
|SBCOBI (MT) aanwenes subscript to binary integer. « | 
fy aeeuses (MT) Vasaaaes COMR triple 
|SBERR (MT) ee error message into dictionary. | 
; enesan ee the FIRST flag setting if it is not already set, and exits 
| junless FIRST was unset on entry | 
feenoe (MT) ladiseates an odd symbolic register. ! 
icemes (MT) Vaenbeutes pseudo-code and moves it into output text block. 
i Soneae (MT) imaaanes nested subscript situation. 
1 | ssorrs (MT) ‘deadies OFS triple | 
ao {Calculates element offset in optimizable cases. 
|SBSBRN (MT) |Checks subscript range. 
icasean rnesneies to KT for scan. 
| SBSTIB leueeaees code to calculate element offset. 
‘sacunt eee array name. 
one (MT) wanes end of subscript list. 
‘ouebe ‘eeneweces code to set up the dope vector of an array of adjustable | 
{ |strings. 
|SBSOS lneeeeas code to multiply subscript by multiplier. 
fataoe ee code to convert to fixed binary. ! 
ianeooe {Checks for occurrence of subscript. ! 
| spa029 {Generates code to multiply subscript by 4 or 8. 
y |sesoss {Generates multiply halfword code modifications 
eevee |Scans for comma, subscript prime, or subscript triple. 
biscan tens |Controlling scan of text. | 
|UTTEMP (MT) jAllocates workspace. 
| forma ce) avert two bytes of storage on a halfword boundary | 
Chapter 3: Flowcharts, Tables, and Routine Directories 293 


@eTable NA. Phase NA Pseudo-Code Branches, ON, Returns 





(Sa ee ee Woe pe SS ee er eS ee ee ee 7 
|Main Processing| | 

| Statement or Operation Type | Routine | Subroutines Used | 
Ss ed ec es eee cgi ena ieee ra ee ele A erento rae at as a oe | 
JInitializes text block | NAINIT {|SCINIT (KT) | 
| -----------------------------------}--------------- }~-----------~---------------------- 4 
|Scans text for next triple of |NASC1, NASC2, |SC1, SC2, SC3 (all in KT) | 
Jinterest to user | NASC3 | | 
}~-----~----------------------------4--------- ponaaapo------- == +--+ == ------------ { 
|Processes STOP statements | STOP | NAUT1 | 
~--------------------------------—}--------------- }~---------------------------------- 
{Processes EXIT statements | EXIT | NAUT1 | 
prawn mannan nnn nnn nnn nnn nn nnn nfo nnn nnn nen nf mn nnn ne mmm enna anno enn nanan { 
| enaaeee* IF triples | IF |NAUTD, NAUT16, NAUT21, ZSTUT1 | 
}----------—------------------------f-------- === ===} = === == 2 === 2-222 -- =f 
{Processes ON triples | ON |NAUTD, NAUT6, NAUT16, SC5(KT) | 
}--~----~---------------------------}-=-------------}-----------------------------------{ 
jProduces Library call at end of |PROCP, BEGINP |NAUT1 | 


Jeach PROCEDURE or BEGIN block in | 
{source text | 


| 
| 

~---~-~-------~--------------------}--------------- }----------------------------------- { 
|] | Processes RETURN triples | RETURN | NAUT1 | 
~-~-------------------------------- $---------------}-----------------------------------4 
|Processes function RET IRN | NA3002 |NAUTB, NAUTCA, NAUT1, NAUT12 | 
|statements for one data type | | | 
}----------------------------------- }--------------- }---~------------------------------- { 
| Processes function RETURN state- |NA3013 |NAUTA, NAUTB, NAUTCA, NAUTD, NAUTF, | 
jments for more than one data type | | NAUT1, NAUT7, NAUT8, NAUT9, NAUT11, | 
{ | | NAUT12 | 
pr-- nnn nen nn nnn fa--- 9 = =f : 
| | Processes GOTO triples | GOTO | NAUTD | 
p= == = = = == = nnn nn nnn anf ann nnn nn nf nnn nnn nnn nnn nnn nnn nnn 
| Processes GOLN triples | GOLN | NAUTU | 

}---------------- == 2 2 - =f nnn nt on nnn nnn a nnn nena == 
jfrocesses GOOB triples | GOOB {NAUTS, NAUTD, NAUT16, SC5 (KT) | 
poa------ = $= $$$ fee  - nn----4 
}Processes SIGNAL triples | SIGNAL |NAUTD, NAUT6, NAUT16, NAUTS, { 
| | |NAUT10, NAUT21 | 
po---------------------------------- $--------------- }-----—--------------------------—-- : 
| (Processes REVERT triples | REVERT |NAUTD, SC5 (KT) . | 
bore ae eee eee eee as ee ae rs oa is i a eee ae J 
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eTable NA1. Phase NA Routine/Subroutine Directory 


| Routine/Subroutine | Function | 
fe reece ee cae er ener ee 
Vaden |Processes GOOB triples. ! 
eons nes triples. 
con eeren GOTO label number (GOLN) triples. 
tee ee IF triples. | 
| AAINIT Initializes text blocks. | 
lneeraiiccayeases |Scan text for next triple of interest to user. | 
antra |Generates pseudo-code to test switch value at RETURN (function 
| |value) statement for more than one data type. | 
ee ee assignment triple to RETURN function result. 
or ee assignment triple set up by NAUTB. ! 
fan leeneyseds indicated pseudo-code. 
lore leone eee pseudo-code to branch to ECU value. 





4 
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@®Table NA1. 


Phase NA Routine/Subroutine Directory (cont'd) 


| Rout ine/Subrout ine] : Function 1 
}--—--------------- }$--------------------------=----—------------------------------------ 4 
| NAUT1 {Generates call to indicated library routine. | 
| | 
| NAUT2 |Moves indicated pseudo-code, deletes current triple, continues text | 
{ jscan. | 
| | oe ; | 
|NAUTS {Makes dictionary entry for indicated library routine. | 
| | 
| NAUT6 | Updates current symbolic register value. | 
| | | 
| NAUT7 {On entry, register BR points at an entry label dictionary entry. On| 
| jnormal exit from the routine, register BR points at the next label | 
| |dictionary entry. Abnormal exit indicates that there are no further| 
| jlabels on the current PROCEDURE or ENTRY statement. | 
| | 
| NAUT8 {Bump EQU* value for branch pseudo-code item. | 
| | | 
| NAUTS {Bump return switch value to be used for current entry label. | 
| | | 
|NAUT1I1 |For current entry label, generate appropriate EQU* pseudo-code item. | 
| | | 
| NAUT12 |Converts current label dictionary reference to an absolute address. | 
\ | | 
| NAUT16 jConverts dictionary reference of triple second operand to absolute | 
| jaddress, loads address into register BR. | 
| | | 
{WAUT17 |Makes dictionary entry for maximum negative number. | 
| | 
| NAIT18 {Makes indicated dictionary entry. | 
| | | 
| NAUT 21 |Generates pseudo-code to compare source bit string, making library | 
{ |comparison routine dictionary entry, if necessary. | 
| | | 
|NA1100 jTests for SNAP. . | 
| | | | 
{NA1140 {Using NAUTD, generates code for ON-units. | 
| | 
|NA3002 jProcesses function RETURN statements for one data type. | 
| | | | 
]NA3005 jOutputs assignment triple. | 
{ | | 
{NA3013 {Processes function RETURN statements for more than one data type. | 
| | | 
{| NASOO3 |Generates pseudo-code for branch and mask, labels. | 
| | 
|} NA8010 jConverts ID to bit-string. | 
| | | 
{NA8012 jOutputs pseudo-code. Compares bit-string to zero. | 
| | | 
{ON | Processes ON triples. | 
| 
| PROCP/BEGINP |Produce Library call at end of each procedure in source text. | 
| | 
| RETURN |Processes RETURN triples. ! 
{ | . 
| REVERT j|Processes REVERT triples. | 
| | 
| SIGNAL {Processes SIGNAL triples. 
\ | 
| STOP |Processes STOP triples. ! 
| 
| ZSTUT1 |String utility in Phase LV to provide a dope vector for a specified | 
| |string. | 
ee en ee a nn I 
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@Table NG. Phase NG Pseudo-Code Operating System Services 


ee ae ey ee yey eee eee ae tne Pe pat a eh Gee eA Wo ewe aN ey Ka ea eee aay ae ae ee ee ene ee ee, 


{Main Processing] | 


| Statement or Operation Type | Routine | Subroutines Used | 
pan nnn nn nnn nn nn af nnn nnn nnn nnn nn nn nnn nn nnn nn nnn nnn a= =f 
| Processes ALLOCATE statements for |ALOCAT |CALIB, FALUT1 | 
{based variables | | | 
}---~-----—------------------ ------ f---------------4 -—---------- ---------------------- 44 
| Processes DELAY statements | DLAY |CALIB, INTEG, SCAN (KT) | 

wan nn nr nnn nnn nnn fren nnn nnn nnn nnn ann nnn anna anne name nna 
{Processes DISPLAY statements | DSPY |CALIB, CHAR, ENDLST, | 
| | |SCAN (KT), STORAD | 
}---------——-- SS RRS ae RPT Cae RT fanaa nn nnn nnn nn ne { 
|Processes FREE statements for based|FREE |CALIB, FALUT1 | 
| variables | | | 
et 
| Processes WAIT statements | WAIT | CALIB, INTEG, SCAN(KT) , OPLAST | 


® Table NG1. Phase NG Routine/Subroutine Directory 


Gee ee poy AD, Shp SMe ee Pe Peet ee AP RE Ra a ee OY fant eG Oe EN Ep eg Pp GTN MeN fe Be per eens RIOT Gh et eT et ampere 


| Routine/Subrout ine | Function | 
catia’. ~~ Generates pare ot caling i@equence and wakes dictionary. entry eon” | 
| |Library routine. | 
{CHAR (NA) oer: a given argument to character string. 
ore iaceesaes DELAY statements. ! 
iseeE ree DISPLAY statements. ! 
[| DSPY3 ae that operand is character variable. 
— fakes dictionary entry for parameter list. 
| DSPY10 ee ror REPLY option. | 
ig ENDLST ceusteeds paraneter list and makes dictionary entry for it. 
eer ies: aryument of ALLOCATE or FREE statements to see if variable 
| jis based and forms RDV in workspace to prepare for call to the | 
| Jiibrary. | 
haere’ (NH) |Converts a given argument to an integer. ! 
race pee to next statement. 
lobes {Builds up parameter list in workspace. 
| STORAD [stores an address in a parameter list. 
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@Table NJ. Phase NJ Pseudo-Code RECORD I/0 


CSS re eae ete nt en a ee Se a ee en ea ee a 1 
{Main Processing| | 

| Statement or Operation Type | Routine | Subroutines Used | 
||Initialize Phase NJ by calling in |STRTNJ |ZLOADW (AA), SCINIT (KT), SC1 (KT) : 
j|block NK and initializing SCAN | | | 
jutility | | 

pre nn nnn nnn nn nnn nn fin nnn nnn nnn wen nnn nner nme { 
[Initializes switches and flags to |NUSTAT | TXTEST | 
jindicate start of new statement. | | | 
{Determines RECORD-oriented I/O verb| | | 
jand goes to appropriate routine | | | 
}-----—---~---------—-----—---------} --------------- ----------------------------------- 
||Gets next triple of interest, | SCNOPT {SC3 (KT), TXTEST, SCANO1, CMPERR 1 
|converts to internal code and | | TXTERR, ZABORT (AA) | 
|selects the appropriate routine to | | | | 
|process it | | . | 
fan nn nh nn nf nnn nnn nnn nnn enn 
|Processes FILE option of RECORD- | FILOPT {| TXTARG, DYNMPL, LAONLY, STDROP, 
joriented I/O by placing dictionary | |CMPERR, TXTERR, WRKSPC, MVPSCD, 
||xeference of FILE Declare DCB in | | ZTXTRF (KT), SYMREG, MV3 (KT) 

jthe appropriate slot of the | 

|parameter list. The parameter list| | 

{is in STATIC if file constant, | | 

| WORKSPACE if file parameter | | 

aa a an eo ee = 


| (RDV) for the triple operand and | - |STDROP, LAOSM2, CRDV, TXTERR, 
[places the address in the second | | ZABORT (AA), WRKSPC, MVPSCD, TXTRF, 
jslot of the parameter list unless | |SYMREG, ZDRFAB (AA), CALLIB, 

{ the operand of the INTO triple is | | ZDICRF (AA), REFRDV, SCALAR, 

|A varying string, in which case it | {| PNTRDR, BSDRDV 

|places the address of the string | | 

|dope vector of the operand in the | | 

{second slot in the parameter list. | | 


| 
| 
| 
| 
| 
| 
jEstablishes the record dope vector |INTFRM | TXTARG, CMPERR, DYNMPL, LAONLY, | 
| 
| 
| 
| 
| 
| 
| 
| 
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Table NJ. Phase NJ Pseudo-Code RECORD I/O (cont'd) 
ee a ee SS re ee a a ee ae ae eee ee 


1 
| {Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
pr -—--——- ~~ ---------- === == $--------—-—-- wpa nn nnn nnn nn nnn nnn -- 4 
| Processes the operand of the | LOCOPT | TXTARG, ZDICRF, PNTRDR, SCALAR, 


{LOCATE triple by establishing the | | LOCRDV, CMPERR 
{RDV for the triple operand and | 
|placing this address in the second | 
|slot of the parameter list. It | 
jestablishes the pointer qualifier {| 
Jof the based variable and saves | 
|jthis, either to be used, or to be | 
joverwritten by the operand of a SET| 
{triple. It establishes a compiler | 
jlabel and puts this in the third | 
|slot of the parameter list in order| 
{to tell the library where to | 
|return, so that code assigning the | 
{pointer value returned in the RDV | 
|to the saved pointer operand is | 
javoided. It then initializes the | 
[based variables just allocated | 


oben ners cece ees ee eee eee edies aomee cee cares GR quae ED eee GED eee GED EE ee ED eee ee ee Se 


}~----------------------—---- ------}}-------- ------ +} 2-9-2 2 $2 ------- == --- = 
| Processes KEYTO option of RECORD- |KYTOPT | TXTARG, SCALAR, DYNMPL, LAONLY, 
Joriented I/O by verifying that its | {|STDROP, NXTMPD, ZSTUT2 (STRUT2 in 
Jargument is a character string, | | LV), LAOSM2, LAOSM1, TXTERR, 

{then placing it in the appropriate | |ZDRFAB (AA), SCS (KT), WRKSPC, 
|paxameter list slot, which may be | |MVPSCD, MV3 (KT), SYMREG 

jin STATIC or WORKSPACE | | 

}-------------— .--~--+---~-------+----}----~-----~+---~+}.-~------- +--+ --- +--+ -- --- +--+ +--+ -- = 
| Processes the KEY or KEYFROM %cption|KEYOPT | TXTARG, SCALAR, DYNMPL, LAONLY, 

|of RECORD-oriented I/0 by l |STDROP, NXTMPD, ZSTUT1 (STRUT1 in 


|converting the argument to a | {LV), LAOSM1, LAOSM2, TMPSEL, TXTERR 

{character string if it is not | | 

{already a character string and j | 

jplacing the result in the l | 

jappropriate parameter list slot; | | 
| | 
| | 
4 


{this is either in STATIC or 


echt came cee ree ees Ga ene eames come cee 


| WORKSPACE 

}------------------------—- ---- ------} --~-------~----}----~--- -- —— - +--+ -- ----- +--+ -- +--+ 
|Processes the IGNORE option of | LGNOPT | TXTARG, SCALAR, CINTEG, DYNMPL, | 
{RECORD-oriented I/0 by first | | LAONLY, STDROP, MVPSCD, WRKSPC, | 
|checking that the argument is a | |MVTRPL, LAOSM1, ZDRFAB (AA), | 
|scalar and then converting to a | |CMPERR, TMPREF, NXTMPD, MV3A (KT), | 
[binary fixed integer if it is not | |WRKSPC, SYMREG, MV3 (KT) | 
jalready a binary fixed integer. | | | 
|The address of the argument is | | | 
|placed in the appropriate parameter| | | 
{list slot in STATIC or WORKSPACE | | | 
a= =~ === = = nf nn fon nnn nnn 
{Processes the event option of | EVTOPT | TXTARG, DYNMPL, LAONLY, STDROP, | 
| RECORD-oriented I/O by checking | | NXTMPD, TMPREF, TXTERR, WRKSPC, | 
|that the argument is a scalar EVENT| |MVPSCD, ZTXTRF (KT), SYMREF, | 
|variable and placing its address in| |Mv3 (KT) | 
jthe appropriate parameter list | | | 
|slot. The parameter list is either| | | 
jin STATIC or WORKSPACE, depending | | | 
jupon the storage class of the ‘| | | 
| argument. | | | 
bea hee eae eee eae ees SS acerca cee ease ioe ie cesta Sa aw oi lab dei ome 
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@e Table NJ. Phase NJ Pseudo-Code RECORD I/O (cont'd) 


[Main Processing] | 
l Statement or Operation Type | Routine | Subroutines Used | 
> De SS LD CEN ED ES SD ARISE AD ES Ee SE SY SE ES eS SE ED NP ED ee SD ea SP ee 4-~----------~~---} wee Se Pee aw wore Sa ae ae a a a> oe ae Sn ae fe ee ae ae om ee oe: 
{Processes the pointer operand of a |SETOPT | TXTARG, SCALAR, NXTMPD, DYNMPL, 


{SET triple. If part of a READ | TMPREF, STDROP, TXTERR 
|statement, the address of the 


| 
jpointer variable is placed in the | 
{second slot of the parameter list. | 
|If part of a LOCATE statement, the | 
|pointer operand overwrites the | 
{pointer taken from the based | 
|variable in the LOCATE statement, | 
Jto be used in the pointer | 
jassignment code produced by ENDIO. | 

4 


ae ae ae cae ame eee ae aes ome 
eben cee cee eee eee eee came See ames mee eee sume anh 


ENDIO |ZDICRF (AA), LAONLY, LAOSM1, 
|CALLIB, MVPSCD, ZTXTAB (AA), SELL, 
}SC3 (KT) SYMREG, TMPREF, 
|ZDRFAB, MVTRPL, RCBCMN 


{At end of I/O statement, places 
{REQUEST _CODE (i.e. IODEF) in sta- 

| |tic constant chain, puts STATIC 
jparameter list in STATIC chain. 
{Creates external Library calling 
jsequence for RECORD-oriented I/0 
[statement as follows: 


EPRM 

LA 1, PARM.LIST 

L 15, RECORD.IO.LIBRARY.ROUT 
BALR 14,15 

EPRM 


| 
| 
| 
| 
| 
[ 
| 
| 
| 
| 
| 
| 
| 
{If there is a WORKSPACE parameter | 
jlist, it updates the MVC or | 
{parameter list from STATIC to | 
| WORKSPACE. It checks whether a | 
{LOCATE statement is being | 
|processed, for which it generates | 
|pseudo-code to assign the pointer | 
|value from the RDV to the pointer | 
|variable and to initialize the | 
|REFER variable of a self-defining | 
|structure. It generates an | 
jallocate triple to indicate | 
jpossible initialization of TASK | 
jand/or EVENT variables, and a | 
|compiler label triple to mark the | 
jend of initialization code for the | 
jlibrary. It generates any SELL | 
jtxriples accumulated throughout the | 
|statement on SELL chain. It | 
[cancels the RECORD-oriented I/0 | 
joption triple codes from the SCAN | 
|TRT interest table. It gets the | 
jnext triple of interest and goes to| 
|NUSTAT to process as a new | 
j statement. | 


Gg ee i sf Oe ke a ee 
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@eTable NJ. Phase NJ Pseudo-Code RECORD I/O (cont'd) 


pat a ee ea ee ee ae ae ee To ee ee ee ae a Cee on ee ola | 
-  |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
onan nan nan nnn nnn nnn nnn nn nnn nnn nnn mn nnn nnn nnmnn| 
jIndicates presence of NOLOCK | NLKOPT | None 
joption. | | 
| |Delete the SELL triple encountered |SELL routine 


(2 
{during scan of RECORD-oriented |at SVSELL or | 
{I/O statement but puts dictionary |TMPSELL entry | 
|xreference in the SELL chain so that|point | 
|SELL triple can be regenerated at | | 
jend of I/O statement | | 


ot 
my 
| 
» 
w 
3 
2 
Ww 
Fad 
a 
2 
ee ae oe ae ease coe he ane oe 


me eee eee mew er enn - -- - -- | 


|At end of program, releases own | PRGEND |RLSCTL | 
jmodules and turns control over to | | | 
jnext requested phase. | | | 
oes 


SE ce ie EE AEE CS SOY A EA Se A ED GD ONE ANS GERD NS GED AED ae aD AE ED aS eee aD a eS eer cme aoe qneneom omens an an rar annem adh 6a San en ReaD ae STEP ENED ER Dahan Nea en ena an anenae wanenaend 
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Table NJ1. Phase NJ Routine/Subroutine Directory 


r 
| Routine/Subroutine 


t 
| BSDRDV (NK) 


CALLIB 


INTEG 


Cc 
CMPERR 
Cc 


oO 
2 
tH 
bo 


ELETE 


o oO 


YNMPL 


| ENDIC 

| EVTOPT 
| FILOPT 
tighoes 
aes 
| KEYOPT 


| 
| LAONLY 


LOCRDV 


x 


YTOPT 


i 


AOSM1 


5 
9 
n 
= 
NO 


MVPSCD 


TITTY 


| NLKOPT 


tw eee ane ee ee eee ee mm hee ees eee ge ER SUD ae eee CD ES GAA EE ED GU ES TD ED ED END TE EEE GSU SS ESRD OUD ED a OD OD GE ee OS ED EP al TaD ee a OP Ow a oe eo a a aan ae ee ae ae 
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RDV (NK) 


(NK) 


(NK) 


(NK) 


(NK) 


(NK) 


(NK) 


(NK) 


= 
| 


|Handles operations at end of I/O statement. 


a aaa i aa ai RN a aa a 1 
: Function | 


[Entry point to CRDV routine which marks it as processing a based 
|variable in an INTO or FROM option. 

{ 

{Creates pseudo-code to call library routine; indicates call in 
|dictionary if not previously noted. 


{Checks whether argument is a binary fixed integer. 
| Indicates compiler error and ABORT, error code in HOLD register. 


{Constructs a record dope vector (RDV) entry in WORKSPACE. If the 
|dope vector descriptor bit is on, then the routine generates a 
[library call to generate the RDV. If the variable has static 
jextents and is not a string, the RDV is constructed from information 
jin the RDV dictionary entry. If the variable is a string, then the 
|RDV is constructed from its string dope vector. 


[Indicates compiler error in the case of a deferred feature not 
{detected by earlier phase. 


| 
{Establishes DELETE code as REQUEST_CODE. 


|Establishes a parameter list in workspace if one is not already 
jestablished. Calculates workspace offset to particular slot 
|requested. Establishes a symbolic working register. Establishes 
|skeleton pseudo-code for LA, ST, and DROP of register into workspace 
joffset. 


{Processes EVENT option. (Not implemented in second version.) 


| Processes FILE option. 


| Processes IGNORE option. 


{Processes INTO/FROM option. 


{Processes KEY or KEYFROM option. 

| 

|Outputs pseudo-code for LA into symbolic work register of a 
|dictionary reference without any offset modifiers. 

| 

jEntry point to CRDV routine which marks it as processing a based 
[variable of a LOCATE statement. 

| 


| Processes KEYTO option. 


jEstablishes pseudo-code for a LA instruction into a symbolic work 
|xegister with the address of WORKSPACE and a literal offset which is 
jpointed to the argument register. 


j|Generates LA pseudo-code in which both base and offset are in 
| registers. 


|Puts pseudo-code assembled in pseudo-code area into output text 
| block. 


|Invokes SCAN utility to move generated triples into output text 
| block. 


j|Indicates presence of NOLOCK option. 


Table NJ1. 


(noo 
|Routine/Subroutine | 


ac a ace ee eae ees 


| NUSTAT 


I 
| NXTMPD 


4] 
: 
y | 


PRGEND 


RCBCMN 


: 


REFRDV 


| REWRIT 


| 
jsc 


SCANO1 


CNOPT 


no On 


CRHOP 


(NK) 


SELL (NK) 


STDROP 


4 
fe 
q 


4) 


YMREG 


PREF 


TMPSEL 


TXTARG 


4 


XTERR 


4 


XTEST 


Q 
: 
a 


WRITE 


2 


| WRKSPC 
| 


| anes 2 enews ae eee eee. 


(NK) 


(NK) 


(NK) 


(NK) 


| boundary. 
oe 


Phase NJ Routine/Subroutine Directory (cont'd) 
a a te nn en 


wall 


Function 


|Handles operations at start of new statement. 

| 

[Invokes SCAN utility to get next triple, which is checked to see if 
{it is a TMPD; if not, it is an error. 


| 

|Establishes the seven-byte pointer information slot in a BASED 
|variable dictionary entry. 

| 

{Releases control to next phase at end of program. 

I 


{Commons the dictionary entries of request code blocks. 


a a hae 


| 
|Establishes READ code as REQUEST_CODE; establishes parameter list 
jsize. 


| 
{Establishes the address of the RDV dictionary entry in the ARG 
|xregister when given the data variable dictionary address in INDX1. 


| 
|Establishes REWRITE code as REQUEST_CODE. 


{confirms that dictionary code byte refers to scalar item; ascertains 
jwhether item is a constant. 


jIndicates compiler error in the case of a deferred feature not 
{detected during Read-In. 


|Gets next triple of interest, branches to appropriate routine. 


|Searches options, inserts RECORD-oriented I/O option entries into 
[SCAN TRT interest table. 


|Generates SELL triples for all dictionary references in the SELL 
| chain. 


jOutputs pseudo-code to ST contents of symbolic work register into 
|parameter list slot in workspace set up by DYNMPL, and the drop of 
{the symbolic register. 


{Initializes phase. 
| 
{Establishes symbolic work register. 


|Generates the appropriate LA pseudo-code to load the address of the 
|temporary described by TMPD. 
I 


|Adds temporary entry to SELL chain for generation of SELL triple 
Jupon completion. 


|Pxocesses second argument of triple. 
jestablishes absolute address in INDX1. 
|TEMP, LR+4 if dictionary reference. 
| error. 


If dictionary reference, 
Returns to LR if zero, i.e., 
If null, indicates compiler 


[Writes error message. 


| 
{Converts function code of triple interest TRT table to internal key, 
jand invokes PRGEND if end of program is indicated. 


| 
|Establishes UNLOCK code as REQUEST_CODE. 


(Not implemented in second 
| version. ) 


i 
|Establishes WRITE code as REQUEST CODE. 


{Establishes the requested workspace area, starting on fullword 


fhe caenee cone cmnee cemee comes OSES gene GAD cee RED OSD eee SEED cee OED eevee SEES eS ES UD gee ED ED SEES CED eee cee TED aEED GE GERD ee ED cee ® eee OD cee ee eee cee ee ee ee ee ee eee 
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eTable NM. Phase NM Pseudo-Code Executable I/0 
Se re ee i Seniperaetoatsa cana ia areata ee a ee a 
|Main Processing] 
| Statement or Operation Type | Routine | Subroutines Used 


+ 
|GET | INSERT, STORAD, INSTFL, GENPC, 

| |GENTR, MVTRSP, ENDLST, CALIB, 
| 

| 


—- 
! 
| 
| 
| 
| 
I 
! 
! 
! 
! 
| 
1 
l 
{ 
| 
! 
| 
! 
| 
{ 
! 
{ 
! 
t 
| 
! 
{ 
{ 
j 
I 
! 
I 
! 
! 
t 
{ 
! 
1 
! 
! 
t 
! 
i 
! 
| 
! 
t 
| 
! 
! 
! 
' 
1 
t 
1 
{ 
! 
! 
{ 
] 
i 
1 
t 
' 
1 
! 
ee ae ed oe 


| |CHAR, INTEG, UTTMPW, SRCERR, 
11 [SCAN (KT), STRUT1 (LV), STRUT2 (LV) | 


}---------—-------------—----------}---------------}-------------------- === -=------ +] 


|Processes OPEN and CLOSE statements | OPEN | INSERT, STORAD, INSTFL, GENPC | 


| |GENTR, MVTRSP, ENDLST, CALIB, | 
| | |CHAR, INTEG, UTTMPW, SRCERR, 

i | [SCAN (KT), STRUT1 (LV), STRUT2 (LV) | 

L 


Table NMi. Phase NM Routine/Subroutine Directory 
Pan Se Rr ay Te, ea Ts OEE ole re ee Pe mS ge ear Arete, AO ee ee 1 
| 


| Routine/Subroutine Function | 
(cattp (NN) [Generates part of calling sequence and makes dictionary entry for | 
| {Library routine. | 
|CHAR (NN) \Goueaee a given argument to character string. 
JENDLST (NN) eh cede parameter list and makes dictionary entry for it. 
{GENPC (NN) {Moves pseudo-code to output. 
JGENTR (NN) Nees generated triples to output. ! 
ass iegeeeaces GET and PUT statements. 
|GETOO i ateiaiages switches for GET/PUT. | 
1Geno6 ieee option. ! 
| Eres ipeecesees end of I/O statement. 
JINSERT (NN) [Inserts dictionary reference in parameter list. 
JINSTFL (NN) ieaweeee file reference in parameter list. 
| INTEG (NN) ooneerte a given argument to integer. 
\MenBee (NN) wee data and format list triples to output. ! 
| NMR1 inegine scan for triples of interest. 
\opEn imaeesees OPEN and CLOSE statements. 
| opENoO Haeiiines switches for OPEN/CLOSE. ! 
es (NN) wakes error dictionary entry. 
|STORAD (NN) iebadeaees pseudo-code to store symbolic register in parameter list. | 
1 UEIMES (NN) obtains temporary workspace. se te wee el 
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@aTable NT. Phase NT Pseudo-Code Data and Format 


|Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
pean nnn rn nn nn nnn nr af nnn nnn en nn nnn nnn nnn nnn nnn nnd 
{Initializes phase, obtains scratch |NT0000 | None | 
| storage | | | 

| |Scans text | NTO003 {NTOO11, NTOO14, NTOO17, NTOO21, | 
| | - |NTOO23, NTOO24, SC2 (KT) | 
~------------——-=------ ~----- ---- — f ---- === - === = - = == === = | 
{Collects remote format items and {NTO0011 | None | 
|saves until end of block | | | 
pena nnnn frown nan nena fanaa nanan nnn nnn n= = { 
jAssociates remote format items with|NTO014 | NTUT10 


| 
jdata list items | | | 

naan === $= = 2 == ff nn a ----------- 
{Makes entries for Library routines |NT0017 | NTUT20 | 
|xequired for EDIT-directed I/O and | | | 
{copies skeletons for phase NU into | | | 
[scratch storage, then releases | | | 
| phase | | i 
[Identifies type of data list item |NT0021 | None | 
jand enters the type code in a list | | | 
}-----~----—---—-----—------—---------} --—----- —-----} ---------- - —-------------—------ 
jAssociates format and data list {NTOO23 | NTUT10 | 
jitems and marks INCLUDE matrix | | | 

mann nnn — nn nnn nnn nn nn nnn 
|Identifies type of format list item|{NT0024 | None | 
jand enters the type code in a list | | | 

aa aH anf nnn nnn nn nnn rn nnn nn nf 
|Sets bits in INCLUDE matrix to | NTUT10 | None | 
|xepresent STREAM I/O conversion | | | 
|xrequirements at execution time | | | 

wan a nn nnn anna fn nf nn nn nnn nnn 
|Makes dictionary entry for Library |NTUT20 | None | 
| Routine | | | 


Table NT1. Phase NT Routine/Subroutine Directory 


|Routine/Subroutine | Function | 
Inroo0o0t—t—~wsS [Initializes phase, obtains scratch storage. i (aiti‘séS~S™S i 
| NTOOO1 [Initializes phase address slots. 
‘encode iatane text. | 
[| NTOO11 {Collects remote format items. 
{NTO014 |Associates remote format items with data list items. ! 
| NT0017 tues entries for Library routines for EDIT-directed I/O. 
| wr0021 | sieneieies types of data list items. ! 
| NTO023 eecciuees format and data list items. | 
|NTOO24 igaaneneiee types of format list items. 
{NT1700 | o EDIT-directed 1/0, therefore no scan pass. 
anor lees bits in INCLUDE matrix. 
eporer [makes dictionary entry for Library routine : 
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eTable NU. Phase NU Pseudo-Code Data and Format Lists 


ee Se tao Ss nn pe ea eee 1 
{Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
{Generate Library calling sequences |NU0022 J INSERT, UT24,UT11, UT23 7 7 
|for data items in DATA-directed I/0| | | 
{statements | | | 
{Generate Library calling sequences |NU0023 | INSERT, UT11, UT25, UT14, UT23, UTO9 | 
|for data items in LIST-directed I/0| | | 
{statements | | | 
ee ee > eee ED ee ee Gee ete GED awe EP aE eee SED CEP ED GED aoe OO oe Ae ee ee ee om oe ee ee 2 SP SP eS Se GP ED ae A GE ED ep EP a a a ae Se a oe ee ae ES CP ee ae OP 6 OP © SD > OP em © we & ow a wee oe 4 
{Generate code for data items in |NU0024 |UTO9,14 | 
|EDIT-directed I/O statements | | | 
| ----- -- n n nnn fe nnn nnn nnn nnn ann nnn nnn nnn nnn nn nnn { 
{ [Scan text {NU0002 jSC1(KT), SC2(KT), SC3(KT) | 
aan = = === nn nn en nnn fanaa nnn ene a2 
|Generate Library calling sequences |NU0029,NU0030 [|UT15,UT18, BCDCNV,UT10 | 
{for format list items {NU0033,NU0037, | - | 
| | NUO050 | | 
te ee oo ee aes ee ee a a eee eee ee aS J 
Table NU1. Phase NU Routine/Subroutine Directory 
amt mz CS, A aa aS a a a 
| Routine/Subroutine | Function | 
~--—-----+——--—-- +--+ 4 -—-- +--+ +--+ + + ee en 5 e+ 
| BCDCNV (NV) |Convert decimal constant to binary. | 
| | . | 
{| INSERT {Add an entry to an argument list. | 
{ | | 
[NUO0002 (NV) |Scan text. | 
| | | 
{NU0022 |Generate Library calling sequence for DATA-directed data list item. | 
| | 
jNU0023 |Generate Library calling sequence for LIST-directed data list item. | 
| | 
{NUO0O24 (NV) {Generate cards for EDIT-directed data list item. | 
| | 
{Nu0029 (NV) {Generate Library call for A or B format item. | 
| | | 
{NUO030 (NV) {Generate Library call for E or F format item. | 
| | | 
|NUOO33 (NV) {Generate code for R format item. | 
i | | 
{NU0037 (NV) |Generate Library call for P format item. | 
| | | 
jNUO005O (NV) {Generate Library call for X, PAGE, SKIP, LINE, C, or COLUMN format {| 
| | item. | 
| | | 
| UTO9 {Make dictionary entry for constant in EDIT or LIST list. | 
| | 
{uT10 ne a constant entry to one of specified type. | 
jurTi1 {Generate Library calling sequence passing argument list. | 
| | | 
,UT14 {Generate code for intermediate result items in EDIT and LIST data | 
| jlists. | 
| ; | 
{UT15 jMake dictionary entry for FED or DED. 
I 
{UT18 (NV) |Generate an assignment triple. 
| | 
juT23 {Generate Library call code. | 
| 
{uT24 |Construct symbol table dictionary entry. ! 
| | 
{UT25 |Set bit in the INCLUDE matrix. | 
bo ee eb no 
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e Table OB. Phase OB Pseudo-Code Compiler Functions 
GSTS re ee bir Sache aims ian tsa ea SS en ee ee aaa | 
| Main Processing} | 
| Statement or Operation Type | Routine | Subroutines Used | 


| |Scans text for BUY, BUY ASSIGN 
|statements and compiler function 
jand compiler pseudo-variables (see 
|Appendix D.8), and transfers to 
jappropriate routine 


+ + 
| | 
| | 
| | 
| | 
| 

oe re ce ee cae ao eres eee ce we a ne a oe cee eee a crm en ene es we ee en ewe 4—-----+-~-~+----- 4----~~---= ee re ee eee ee ee ee 
| 
| 
| 
| 
| | 
| | 
+ 


perenne 


SCAN (KT) 


5 
f 


| {Replaces MIF compiler functions BUFIZE, FRSTOP, SC3 (KT) 
| (Appendix D.8) by pseudo-code move 
{character instructions, adjusting 
jthe target field to controlled or 
jtemporary type 2 workspace where 
|necessary 


| |Replaces ADV compiler functions 
| (Appendix D.8) by pseudo-code 
Jinstructions to load specified 
jelement of a dope vector into a 
| register 


: 


SC3 (KT) 


| |Replaces SDV compiler functions 
| (Appendix D.8) by instructions to 
jload the maximum length from a 
|string dope vector into a register 


| er eee ees 


BUFIZE, STACK, MV3A (KT), FRSTOP, | 
DROPRG, USTACK, SC5 (KT) 


|Replaces compiler pseudo-variable | 
{triples and compiler assignment | 
jtriples by pseudo-code instructions | 
jwhich store the value assigned in | 
|jspecified part of dope vector | 

4 


ae a ah ean He nn en errr ee eee ree 


| |Rerwove BUY, BUY ASSIGN, and SELL ST8, ST10, ST7 |SC2, SC3 (both in KT) 


jstatements for scalar 
|non-adjustable temporary variables 
|from the text, and allocate storage 
jin the pseudo-code workspace for 
|the temporaries 


ee ene qncen cums come come adie qx comes ane anes ame 


eh eee eee nee ae ee ee 





|Generates code to drop a symbolic |DROPRG | None 
|xegister, or mark a literal | | 
|xegister not wanted | | 


toca ae ce nes co DE ee Qe Ge eo ee oe ee ee ee ee Leeman bana eee enw ean ewe ae ee owe ee | 


om come ome alien 


Chapter 3: Flowcharts, Tables, and Routine Directories 307 


@® Table OB. Phase OB Pseudo-Code Compiler Functions (continued) 
ce a a a a co Ee a en ee ee 1 
{Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
|Determines whether the target 
{dictionary reference of MTF 
|function, or ADV or SDV 
|pseudo-variable is controlled or a 
jtemporary type 2. If it is, the 
|dictionary reference is replaced by 
|the dictionary reference of the 
jcontrolled or temporary type 2 
jworkspace, with the appropriate 
joffset, if the target is a 
|structure base element 
|Stack and unstack the information 
|specifying the target field of 
jcompiler pseudo-variable assignment 


STACK, USTACK 


SETDVF 


elle eee eee ee ee me ee ee ne ee ee ee ee 


|Calculates the offset of the dope 
|vector of a structure base element 
{from the start of the structure 
|dope vector 


| 
| 
| 
| 
nn nn an err nt ef rs rr re | 
| 
| 


ae i ce ee aes ee ee ce ces ne ee ce ee a ee ee ee 


| {Place triples from the source text |BUFIZE jscS (KT) 
Jin an internal buffer. | | 


bo a en en a Le ee ae ee eb re en ee 4 
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Table OB1. 


Phase OB Routine/Subroutine Directory 


jthe text, and allocate space for the temporary variables in the 


a a age gE a ee ee re an pen rag ery Seeger ey 
| Routine/Subroutine| Function | 
SO ED Gee AER Om ES CS Ee GES en ee cee EE ee ee ee ee ee ee ee ee ee ee ee © ee ee ee ne ee ee a a ee ee ----~{ 
| ADVR |Replaces ADV compiler functions by pseudo-code instructions to load | 
| {the specified element of a dope vector into a register. | 
| | | 
jAT7 |Generates pseudo-code. | 
| | | 
|ATS |Replaces operand by workspace reference. | 
| | 
| BUFI ZE {Places triples from the source text in an internal buffer. \ 
I | 
| BY5 {Tests length of string. | 
| | 
| BY19 | Processes string temporary (dope vector only). | 
I | 
| DROPRG {Generates code to drop a symbolic register or mark a literal | 
| |xregister not wanted. | 
| | | 
| FRSTOP |Replaces the target field of MTF function or compiler | 
| |pseudo-variable by controlled workspace where necessary. | 
l | 
{|MTFR {Replaces MTF compiler functions by pseudo-code move character | 
| | instructions. | 
| | 
| SDVR {Replaces SDV compiler functions by pseudo-code instructions to load | 
| {the maximum string length into an object register. | 
| | 
| SETDVF {Calculates the offset from the start of a structure dope vector to | 
| jthe dope vector of a particular base element. | 
| | 
| STACK/USTACK |Stack and unstack information specifying target field of compiler | 
| |pseudo-variable assignment. | 
| | | 
{| ST1 {Scans text for BUY and BUY ASSIGN statements, compiler functions, | 
! jand compiler pseudo-variables. | 
| | 
{ST4, ST6 {Replaces compiler pseudo-variables and compiler assignment triples | 
| |by pseudo code instructions to set the assigned expression, | 
| |converted if necessary in the specified part of a dope vector. | 
{ | 
|ST7,ST8,ST10 |Remove BUY, BUY ASSIGN, and SELL statements for fixed scalars from | 
| | 
| | 
L 


|pseudo-code workspace. 
4 


| 
| 
| 
| 
: 
| 
: 
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Table OD. Phase OD Pseudo-Code Assiaqnment 
CSS a ere Ss ee ee ee ee a a 


| |Main Processing| 


1 

| 

| Statement or Operation Type ] Routine ] Subroutines Used 
wan nnn nnn na af nn nnn nnn nnn nf nnn nnn nnn nn nnn nn nnn nnn nnn 
|Get block of scratch core | SCRCOR | None | 
ba ee ee ae ee See eee Be A See ee ee ae oat ee 4 
{Move routines, constants and tables|MOVTAB . | None | 
jto block | | | 
ieee eee ee ee ee ee a a ee, J 


Table OD1. Phase OD Routine/Subroutine Directory 
--".- -- i a ee Ss ee ee re en een eh te a erst ee s) 
| | 


Routine/Subroutine Function | 
a a a a ca a SN a a aac en a mre Sear ieee 4 

| SCRCOR JObtains block of scratch core. | 
| | 

| MOVTAB |Moves routines, tables and constants into scratch core. | 
i ee ee a ee ee rt ee ee oe oe ee ee re ee so ee ee or ew Jj 
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Table OF. Phase OF Pseudo-Code Assignment 


Frcs ate ee ee nD ae Oe a ee aan aan Se SS a ee ew ee wee ew wee wee 


[Main Processing| | 
| Statement or Operation Type | Routine | 


4 
{Generates pseudo-code for {ASCO0, ASCDOO, ASDROP | 
[assianment triples | | | 


| ----------------------~------------}---------------}---------------------------------=-4 


\ 
JASFD00 (OF) 


Generates 


code for fixed decimal assiqnments. 


{Generates Library calling sequences|ALLOC, FREE, | CALIB | 
{for ALLOCATE, FREE, 3UY, and SELL |BUY, or SELL | | 
{triples | | | 
Ae EE ST EE SS eR age ED ED OE wc EO AE ATS ei ew SE yee ea ean cs Ss ein as es cs “nny stows sce sass ms ae ee ce ee ee ee ee ee ee ee ce ee eee Jj 
Table O£1. Phase OE Routine/Subroutine Directory 
(Rn a Spa re ee ay a a eS I ee Oe Grae Oey Ge ee tne 1 
| Routine/Subroutine| Function | 
na nn =f = a nn nnn nn nnn nnn nn nn nnn nnn nnn nnn nf 
{ALLOC (OF) | Processes ALLOCATE triples. | 
I | 
}ASCOO {Inserts target types for constants. 
| | 
{ASCDOO {Controls assignment of real and complex data. 
! | 
| ASL2CP |Drops symbolic registers. 
| | 
| ASFBOO {Generates code for fixed binary assignments. 
| | 
| 
\ 


\ 
| ASFLOO 


}|Generates code for floating-point assignments. 
| ASLOO Vidabeatas code for label assignments. 
FOOCy. Vestecaese code for pointer/offset assignment. 
IASEROD lesneeates library calling sequence for area assiqnment. 
tagso0 {Processes assignment triples. 
i age0a2 {Tests for special assignment triple. 


{ 
JASTROO (OF) 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
code for string and numeric field’ assignments. | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


|Generates 
iaae (OF) iazeedesee BUY triples. 
ere (OF) canesveas Library calling sequences. 
ee ieeapees for SIZE prefix option. 
eae (OF) {Processes FREE triples. 
Veenoay \dankvaces convert macro instruction. 
eer |Generates RX instruction. 
ieensea {Generates SS instruction. 
‘ cerons ree operand description. 
aha aeneees index from operand. 
epee |Obtains next symbolic register. 
‘oeir (OF) hiveeeenee SELL triples. 
| 
| 


SPASS (OF) 


| Processes 


special assignment triples. 
r Pp 
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eTable OG. Phase OG Library Calling Sequences 


Cat ee oS es Oy Ue ea ee ee eee Ee eee 7 

jMain Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
~---~---~-—--~~+-~------—-- ~-------}---------------}-------- +--+ --- +--+ +--+ +--+ +--+ ---- 
{Scans triples and takes action on |TRSCAN | EOBIN, TSCSNO, TSCCLB, TSCPRC, FMTO01, | 
{their values { | TSCEOP, TSCEP2, JSCIMP,MOVITM,MOVOUT | 
}-----------------------+---------— $--------------- }~---------------------------------- 1 
{Scans pseudo-code deleting IGNORE |PCSCAN | CNVFND, MOVITM, MOVOUT | 
Jitems and detecting CONVERT items | | | 
pana a nn nnn nnn nnn nnn nnn in fname nnn nnn nn nnn nnn nnn 
JExamines fields of CONVERT, and | TEMOH |MJG201, TIEMOI,CODCAL | 
|determines whether the conversion | | | 
jis to be done in-line | | | 
~--------------------------------- }---=----------- }~-~-~------------------------------| 
{Generates Library calling sequence |MJG201 |MJG203,MJG204,MJG298 ] 
nate ea a ee eae acct 4—--------~~~~-~}----~------~----- +--+ +--+ -- + +--++- 
{Generates in-line code for selected|IEMOI | BITODI, FDTOFB,FIBFLT,DECFLT,PICHAR | 
| conversions | | | 
~--~---~---------------—-----~----}--------------- }~--~~----~-~-~---------------------4 
{Generates in-line code for pictures] IEMOL |SILCON, MOVOUT | 
containing not more than four of | | | 
jthe insertion characters (/ , . | | | 
jblank), if the target field is | | | 
|fixed decimal, fixed binary, float | | | 
|decimal or float binary | | | 
aa a ae a a ac a el a cee a ene ae tad 
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eTable OGi. Phase OG Routine/Subroutine Directory 


| [the insertion characters (/ , . blank), if the target field is 
| {fixed decimal, fixed binary, float decimal or float binary 

| | conversion. 
t 


[Routine/Subroutine} ~*~ *#Functions=S—st—“‘(SDCt;*™*™WOO i 
froprn jececeed vhen aarond Ge ode ick Woiiec da datecea, : 
| TSCSNO iseoaleaee SN, SN2, and SL triples. . 
| TSCCLE ecoceauee CL triples. | 
| TSCPRC ‘ bceiace PROC, PROC1, BEGIN, and BEGIN? triples, and sets up uses 
{ |for work space requirements. | 
ened Vesutiiae the workspace requirements for FORMAT and FORMAT LIST. | 
fo eebeasaee EOP triple. 
retees eeeeesies EOP2 triples and terminates phase. ! 
| TSCUMP |When a JUMP triple is found the routine sets up a counting enanian 
| Jand enters PCSCAN. | 
| MOVITM | {Moves from input an item which spans blocks. | 
ee eee an item to the output block. 
| CNVFND ee a CONVERT is found passes control to IEMOH and outputs ! 
| |pseudo-code generated on return. | 
{MJG201 (OH) leona tadas pseudo-code to call the Library conversion package. 
|CODCAL (OH) co a DED generates a code byte used by the in-line conversions. 
|MJG203 (OH) Necneecess pseudo-code to point registers at data. ! 
|MJG204 (OCH) nee pseudo-code to call Library conversion module. ! 
| 136298 (OH) tees bits in include card matrix. ! 
{BITODI (OI) ea deavee in-line code for binary to decimal conversion. 
|FDTOFB (OI) lecaesnees in-line code for decimal to binary. conversion. 
|DECFLT (OL) {Generates in-line code for decimal to float conversion. 
{FIBFLT (OL) [Generates in-line code for fixed binary to float conversion. 
{|PICHAR (OL) {Generates in-line code for picture to character string conversion. 
|SILCON (OL) |Generates in-line code for pictures containing not more than four of | 

| 

| 

| 
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Table OM. Phase OM In-line Data Conversions 


CS a ee ne ee Borg ee eh a ee ee ee eee eee 1 

|Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
}---------------~-------------------}---------------}-----------------------------------4 
[Scans text for CNVC macros | TEXTSC | None | 
}-----------------------------------}---~-----------}-----------------------------------4 
|Passes control to code generation |CNVCDE | PACK, UNPACK, EDIT, EDMK | 
jroutines | | | 
eR Si a ee Ren re ee aa ee lS ere oy ae i ieatee ee aes Se eye Dea ee ee eee Sea a eh J 


Table OM1. Phase OM Routine/Subroutine Directory 


oe ee re a ee Se ee Se ee ee re ee 1 
|Routine/Subroutine | Function | 
Se as a ce a NN a a a ee 4 
| CNVCDE {Passes control to the in-line code generation routines. | 

| 
| EDIT : {Generates conversion code, based on the ED instruction, for FIXED | 
| {DEC to PICTURE conversion which includes punctuation and/or zero | 
| | suppression. | 
[ ‘ | 
| EDMK |Generates conversion code, based on the EDMK instruction, for FIXED | 
| |DEC to PICTURE conversion which includes a drifting sign. | 
| | | 
[PACK (ON) |Generates conversion code, based on the PACK instruction, for | 
| | PICTURE to FIXED DEC conversion when the picture contains only 93's_ | 
| jand V, and has only external sign or edit characters. | 
| I | 
| PTNGEN |Generates the editing constant or mask used by the ED or EDMK | 
| Jin-line instructions. | 
| | | 
| TEXTSC |Scans text for CNVC macros. | 
| | 
| UNPACK (ON) |Generates conversion code, based on the UNPK instruction, for FIXED | 
| |DEC to PICTURE containing only 9's and V, and with only external | 
| |sign or edit characters. | 
ea ee RE cere S, Sen S IN ode ea mD SS ere RePEc e eaeae e eN 
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Table OP. Phase OP Further In-line Conversions 

(Tr re ne et ee a gs eee ee ee a ne ee ee ee a ee 
[Main Processing] | 

| Statement or Operation Type | Routine | Subroutines Used | 


I + + 
{Initialize and perform test scan to|TEXTSC | CNVCDE | 
[search for convert macros | | | 


p--~-~----—------------------------- f= === === == =f 2-2-2 n= === === == +4 


{Examine convert macro and select | CNVCDE | BNTOBT, BTTOBN, FLTOBN | 
{routine to generate in-line code _ | | | 
ee ee ae ee ee ee ae _—a 2 oe oe an 6s ee eee ae en Cees > ee at ee et a a a > Oe ee Ge eS a OP OO om oe Oe em oe ee ee ee ee oe dj 


Table OP1. Phase OP Routine/Subroutine Directory 
SS De ee or gt ng ee ee ee Ge ee On ete pe ee Oe 1 
| Routine/Subroutine | Function | 


| BNTOBT {Generate in-line code fcr conversion from fixed binary to bit string| 
| | 

| BTTOBN |Generate in-line code for conversion from bit string to fixed binary| 
| | 

| FLTOBN {Generate in-line code for conversion from float binary to fixed | 
| | binary | 
J 


De wi ee ew ee ce ma ae eee rus caee ally eum ame ame wee Cs SEED Ge wee ED a eee > Ee ee es oe ee Gee oh am ee a ee ee om en es oe ee ae a ee en ee ee re ee oe ee ee ee 
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Table OS. Phase OS Constant Conversions 


SSS re ee ee eae We a pt ere ee PR ett nae eae ae Oe Pt a ee ne ee 1 

|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
}----------------------------------- }~--------------}-~--------------------------------- 
|Scans constants chain for double | SCAN1 | POOLSC, SCN010, STPTST 
jword constants | . | | 
a i nn ef 
{Scans constants chain for single | SCAN2 | POOLSC, SCNO10, STPTST : 
|word constants | | | 
|-------------------—-------------— $--------------- }----------------------------------- 4 
{Scans constants chain for unaligned|SCAN3 |CONVRT, IADENT, SCN010, STPTST | 
| constants | | | 
~---------------------------------- }-~-------------}--------~--------------------------4 
{Scans through constants chain for |SCAN4 |CONVRT, STPTST { 
jall constants used to initialize | | | 
{STATIC storage | | | 
~------~----=----------—-—--------- }---------------}--------------------------------—-4 
|Sets up parameter and branches to |CONVRT | ARARD, ARBTD, ARCHD, CHARD, ERROUT, | 
[the correct conversion routine | | IACONV, IASTRN, IHEVFA, IHEVFB, | 
| | | IHEVFC, IHEVFD, IHEVFE, IHEVKF, | 
| | | IHEVKG, IHEVPA, IHEVPB, IHEVPC, | 
{ i | IHEVPD, IHEVPE, IHEVPF, IHEVPG, | 
| | | IHEVPH, UPAA, UPAB, UPBA, UPBB, | 
| | | VSAA, VSCA, VSDA, VSEA, ZEROPT | 


Table 0S1. Phase OS Routine/Subroutine Directory 


SS a a reer ewan 
| Routine/Subroutine | ; Function | 
a a fe ee ere ref 
| ARARD |Handles the linking of routines required for any arithmetic to 


| jarithmetic conversions (corresponding Library module IHEDMA). 


| 
| ARBTD J|As above for arithmetic to bit conversion (corresponding Library 


| 

| 

| 

c | 

| jroutines IHEDNB). | 
l { 
| ARCHD {Arithmetic to character (IHEDNC). | 
| | | 
| CHARD |Character to arithmetic (IHEDCN). | 
{ | . { 
| CONVRT {Sets up parameters and branches to correct conversion routine. | 
1 | 
{ ERROUT jHandles the output of error messages for the conversion routines. | 
i | | 
| LACONV {Handles conversion to arithmetic type. | 
i | | 
| LADENT |Makes dictionary entry in the constant pool, generating a new | 
| ]constant pool block if necessary. | 
| | | | 
| LASTRN jHandles conversion to string type. | 
| | 
|IHEVFA (OT) jConverts radix long floating-point binary to packed decimal | 
| j intermediate. | 
| ee 
|IHEVFB (OT) {Converts long precision floating-point number to fixed binary. | 
| , , | 
{IHEVFC (OT) jConverts long floating-point number to floating-point variable. | 
| | | 
|IHEVFD (OT) |Converts fixed point binary integer with scale factor to long | 
| |jprecision floating-point intermediate. | 
| | ; — \ 
JIHEVFE (OT) jConverts floating-point number of specified precision | 
| j{ floating-point. | 
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Table OS1. Phase OS Routine/Subroutine Directory (cont'd) 


poo + ---- === ---- 
| Routine/Subroutine 


T 


| : Function 


oS ce me ee ce a ee ee ce a ce me me a a a an ce ee ee a a ee ee ee ee we ee ee ee “41 


mene + - Ft ee ee re a ee ee ee ew ee o--------------{| 


| IHEVKF (OU) 
IHEVKG (0U) 


HEVPA (OT) 
HEVPB (OU) 


I 
I 
IHEVPC (OU) 
Ir 


IHEVPG (OT) 


IHEVPH (OT) 


LDCONP {Points to head of constant chain. 
| 

POOLSC |Given a converted constant in scratch storage, scans the existing 
|pool for an identical entry. If such an entry is found, the pool 
joffset and dictionary reference of the entry is moved into the 
{dictionary entry for the constant. 
| 

SCAN1 |Scans constants chain for double word constants. 

SCAN2 {Scans constants chain for single word constants. 
| 

SCAN3 {Scans constants chain for unaligned constants. 

SCANS |Scans constants chain for constants used to initialize static 
| storage. 

SCNO10 {Controls the calling of the conversion routine CONVRT and pool scan 
jxroutine POOLSC and, if required, IADENT. Also handles the case of a 
jconstant given in internal form. 

STPTST {Checks for the end of the constant chain. 

UPAA (UPAB) (OT) |Produces zero real (imaginary) part for CAD (corresponding. Library 
jmodule IHEUPA). 

UPBA (UPBB) (OT) |Produces zero real (imaginary) part for numeric field (IHEUPB). 
| 

VSAA (OT) {Convert from bit string to bit string (IHEVSA). 

VSCA (OT) {Convert from character string to character string (IHEVSC). 

| 

VSDA (OT) [Convert from character string to bit string (IHEVSD). 

VSEA (OT) |Convert from character string to pictured character string (IHEVSE). 
\ 

ZEROPT {Produces a zero real or imaginary part for a constant given in 
jinternal form. 

Ds ic a a a e 


{Converts packed decimal intermediate to decimal fixed or 
| floating-point numeric field with specified precision. 


|Converts packed decimal intermediate to a sterling numeric field, 
{with specified precision. 


{Converts packed decimal intermediate to long float. 


|Converts packed decimal intermediate to an F format item. 
{Converts packed decimal intermediate to an E format item. 


jConverts packed decimal intermediate to a decimal integer with 
{specified precision and scale factor. 


{Converts an F or E format item to packed decimal intermediate. 


{Converts a decimal integer with specified precision and scale factor 


jto packed decimal intermediate. 


|Converts binary fixed or floating-point constant to long precision 
| floating-point. 


jConverts bit string constant with up to 31 significant bits, to 
{floating-point with long precision. 
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Storage Allocation Logical Phase Flowchart 
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Chart PA. Phase PA Overall Logic Diagram 
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Chart QU. Phase QU Overall Logic Diagram 
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Chart OX. Phase QX Overall Logic Diagram 
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Table PA. Phase PA DSAs in STATIC Storage 


er ee ee aan eR aaan ae ae mca a CSR ee Ss ee ee ee en 1 
; _  |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
{Scans Entry Type 1 chain for blocks|PADSA | DSASIZ, DVSIZE | 
jeligible for STATIC DSAs | | | 
PS a rt te eee ener sare a4 
{Makes a dictionary entry for each |DICENT | None | 
{STATIC DSA { | | 
~--~--~- ------- ---- ~~ == = === =f = $f o-oo nn nnn nnn =f 
[Sorts STATIC chain (called from PD) |SCSORT | None | 
i aca cl kn a hh a eta ae a elt 4 
{Scans STATIC chain for INTERNAL | ARRSCN | None | 
jarrays; calculates number of | | | 
jelements for those arrays needing | | | 
jinitialization. Allocates storage | | | 
{for arrays and, if necessary, for | | | 
|secondary dope vectors | | | 
a a a a a ee a ee eo ea ) 


Table PA1. Phase PA Routine/Subroutine Directory 


[Routine/Subroutine} ~~~ Function’s—“(atswtt—<—SsSSSCS 1 
[ARRSCN (scana GURTEC chain for ENTSRNAD arrays) allocates storage: for acreys| 
| jand secondary dope vectors (called from PH). | 
|DICENT late a dictionary entry for each STATIC DSA. 
|DSASIZ cniewtseds size of DSA excluding Register Allocator Workspace. 
| DVSIZE leckng AUTOMATIC chain for variables requiring dope vectors, and 
| |calculates size of dope vectors. | 
| PADSA \ puceeetines eligibility of a block for a STATIC DSA. 
\eeadae facets STATIC chain (called from PD). 


Ca en ee a coe ae eee ee cece we cc ce ws ee cerca as en nes ee ce ee ee me ee ne es ce a ee ae ee ae ee ee nee er ee oe ae ee 5 ee ee 
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Table PD. Phase PD Storage Allocation Static 1 


(ian mca alent PD Ee OE DE SS Ree SS oe peadiaachy heat ~~ we ee wwe Somalia (cmacae inv abate SS 2S SS SO OS Sw ee ewe ew oe 


r |Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 
}----------------------------------- +--------------- $----~------------------------------ : 
|Reverses second file dictionary | PD | NXBLCK | 
|pointers | | | 
~~ ~~~-=--~-------==---- ~~ === += === =- fonn anne nn nnn nnn n= === ; 
{Sorts STATIC chain {SCSORT (in PA) |None | 
-~~------~--~-----=-~-- == ---- === +--+} += === === === += == == $= = === === === 
|Allocates storage for simple, | STATIC | SDSA1 | 
j|non-structured, non-external items | | | 
wn nanan nnn nn nnn nnn nnn nnn nn nnn nn nnn nnn nnn nnn nnn nnn nnd 
|Allocates dope vectors for all | DVALOC | None | 
{non-external items | | | 
pra —-- =a nn nnn nn nnn nnn nanan nnn nn nnn nnn nnn nnn nnd 
|Allocates 4-byte addressing slots; |TVALOC | STRCDV | 
[calculates control section size for| | | 
jall external items | | | 
}~------------—--------------- === fonman nn fomn nn nnn nnn nnn nnn nnn nnn + 


|Allocates storage for constants. | CONALC | None | 


Li+  L eh 


Table PD1. Phase PD Routine/Subroutine Directory 


te eM, ae Te FE Ee a ee Ng ee ne a Rap ee en Te ep RSS MEST PSP be gn a epee eae PEER oN 


jRoutine/Subroutine | Function | 
outa edieeene sea ee 
| DVALOC {Allocates dope vectors for all non-external items. 
iaRreR lebeseas next text block. 
\pp |Scans text file and reverses second file pointers. ! 
| SDSA1 iAvieestes a 4-byte address slot for each STATIC DSA. ! 
i aeeoee oe STATIC chain. 
{STATIC j{Allocates storage for simple, non-structured, non-external items. 
| STRCDV ' {Allocates relative offsets of structure member dope vectors. 
| TVALOC {Allocates 4-byte addressing slots; calcnlates control section size 


{ jfor all external items. 
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Table PH. Phase PH Storage Allocation Static 2 


|Main Processing| 


| Statement or Operation Type | Routine | Subroutanse Used 

|Scans AUTOMATIC chain; allocates | PBSCAN | AUTO4, SKDV1, SKENT3, STRSCN, 

|dope vector | | TEMPDV 

we + fe 2 a oe & Oe Se ee ee Ss BP POOP SSO 2 ew we Oe ese = ae 

jScans CONTROLLED chain | CONSCN jAUTO4, SKDV1, STRSCN 

{Allocates storage for skeleton | SKARGL | None 

jargument lists appearing in STATIC | | 

| chain | | 

+ 
{Scans STATIC chain for INTERNAL {ARRSCN (in PA) |None 


Jarrays; calculates number of 
jelements for those arrays needing 
jinitializing. Allocates storage 


a Mek 


| 

| 

| 

ee ee en ee en Fe I 0 EO te EE SP 8 Fe ah SE OS OS OE OP Sr ee 0 se re re eee ar Oe eee oe OD a a ee a Ae a Ci a Cn a ae —~-—4 
| 

| 

| 

| 

| 


| 
|for arrays and, if necessary, for | 
|secondary dope vectors | 


ce ee DD OD CRD EEE et CE OP ES SEP OE OS a EY ee, OS ee OP ee Se LEED chee CU OEE ES EE SS EE os om. ere ge Gb em ce ae os Ge aa am ae ee oe em oe oe oe oe we ee oe ee es 


|Scans STATIC chain for INTERNAL | 
jstructures. Calculates number of | 
jelements in structured arrays | 
|needing initializing. Calculates | 
jsize of storage for all structures | 
{and bumps location counter. | | 


tL... en ee ee ee 68 oe ro aes oe ee oer ere a can nt case lle Sem cae menses cs a as eh oe aw — Lb... — wee we er wee eS PES Se ewe eS eee = 
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Table PHi. 


[Routine/Subrout ine | Function | 


Phase PH Routine/Subroutine Directory 


frerrren SS 8 ee Pe eee Saye 


JARRSCN (in PA) 


| 
| AUTEND 


| 
| AUTOS 
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fare 
for 
| 210513 
ae 
‘eRe 


| 
| SKARGL 
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i 
| SKARG1 
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| SKDV1 
SKENT3 
STRALO 


STRSCN 
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|Scans STATIC chain for INTERNAL arrays; allocates storage for arrays 
jand secondary dope vectors. 


{ 
|Tests for end of AUTOMATIC chain. 


{Calculates size of dope vectors for dynamic temporaries and 
| CONTROLLED variables. 


| 
| 
| 
| 
| 
| 
| | 
|Scans CONTROLLED chain. | 
| | 
|Tests for end of STATIC chain. | 
| 
|Stores STATIC location counter and releases control. | 
| 
{Scans AUTOMATIC chain; allocates dope vectors. | 
I | 
{Gets next item in chain. | 
| 
|Allocates storage for skeleton argument lists appearing in STATIC | 
{chain. | 
| 
jAllocates storage required. | 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
Jj 


{Creates skeleton dope vector dictionary entries for non-structured 
|variables in AUTOMATIC and CONTROLLED storage. 
| 


|Constructs skeleton dope vector dictionary entries for function 


‘|values. 


{Calculates number of elements in structure arrays to be initialized; 
[calculates size of storage for all structures. 

| 
|Creates skeleton dope vector dictionary entries for Structures in 
{AUTOMATIC and CONTROLLED chains. 


|Creates skeleton dope vector dictionary entry for temporary 
Teor reeace: 


i as ar a a ey Se eS Shur ns ets a ea as ag amy So se Sa ae SS enc wn aos Seni Sy ci ee 


able PL. Phase PL Storage Allocation Symbol Table and DEDs 











Be ee a ee ae rn ee 1 
|Main Processing] | 

Statement or Operation Type | Routine | Subroutines Used | 

PD EE ED ONE ES Ae AP POD SS EP DCD SD GP SP AEE ED OED ED ED ee EP EE ae Ge 2 EE SY ED EE ED APR ED ETD AT ED 0 OP SP OE ON OD ED OEE EF OP OE OF RSS SSS SCS SS Swe 4 
Allocates STATIC storage for all | IEMPL | BCSCAN, CCSCAN, CNSCAN, SCSCAN | 
symbol tables and DEDS | | | 
---------—_—----—--—-—----—--- }----------—--- }-----—----—-—--------------------- : 
Scans STATIC chain for symbol and |SCSCAN | DEDAL1, STRSCN, SYMTAB | 
DED variables | | | 
eR AR ree ee, ERE eR RE (ee OR ee Re iy oe a a ee 4 
‘Scans CONTROLLED chain for symbol |CCSCAN |DEDAL1, STRSCN, SYMTAB | 
|and DED variables | | | 
proann = = - == == + = +--+ ------- + = == 4 
|Scans PROCEDURE block chain of | BCSCAN |ACSCAN, DEDAL1 | 
|ENTRY type 1 entries | | | 
|Scans AUTOMATIC chain for symbol | ACSCAN |DEDAL1, STRSCN, SYMTAB | 
jand DED variables | | | 
pa a nn nnn nnn nnn nnn nnn nn nf nn nn nnn nnn nnn nnn nen { 
|Scans chain of members of | STRSCN |DEDAL1, SYMTAB | 
{particular structure for symbol and| | | 
{DED variables | | | 
|------—---—---------—-----—--------} ---~--- ------- - + ----- ++ === = 4 
{Allocates storage for symbol tables|SYMTAB | DEDAL2 | 
an nna ne nf nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn 
|Allocates storage for DEDS |DEDAL (two | None | 
] jentry points: | | 
{ |DEDAL1, DEDAL2) | | 
ee aa a a ee ee eo ee eee J 


Table PLi. Phase PL Routine/Subroutine Directory 


| Routine/Subroutine | Function | 
iMGscA” «= «=O Mahe Abn IC Cain dor ayabol sed Da) variables. SC 
eee faaeae procedure block chain of ENTRY type 1 entries. 
fore teases controlled chain for symbol and DED variables. | 
icnacan levees constants chain for DED variables. 
omar (PM) halbesese storage for DEDs. ! 
eer haiaeeaves STATIC storage for symbol tables and DEDs. ! 
reesei lox STATIC chain for symbol and DED variables. | 
| STRSCN ‘Siena chaie of members of particular structure for symbol and DED 
| | variables. | 
| sera (PM) [allocates storage for symbol tables. 


| nn a nn wn rt we wr ee eo rw a ee ee ow ee ee oo wen a ae 
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Table PP. Phase PP Storage Allocation Sort of AUTOMATIC Chain 


fo Sa en er Pe a ee ome a om os ee eee GD ee ae oe > ge 


SE ered ea ng ee ae nn Re A _ 
| |Main Processing| | 
{ Statement or Operation Type | Routine | Subroutines Used | 
fan nn nnn nnn nnn nf nnn nnn nn nf nnn nn nn nn nnn nn === 4 
|Scans BEGIN-ENTRY for ENTRY type 1 |RAO |SETCH, SCRUB1, SORCH | 
jentries | | | 
nanan nn nnn nn af nnn nn nnn nnn np nan in ern nn nnn nnn nnn —4 
|Scans AUTOMATIC chain from each | SETCH |EXDT, SRCH2 | 
JENTRY type 1 entry | | | 
ma = == $f on nnn nn nn nnn nnn nnn : 
Adds ON conditions to first |Sc24 | None | 
|AUTOMATIC zone | | { 
aa nanan nn nn nnn nnn nnn nn nn nnn np nnn nn nn nnn nn nnn nnn nnn nen { 
|Adds temporaries (type 2) and {sc31 | None | 
jindependent items to first zone | | | 
A RS ED ED EE ND SO EP OD A ES ee EE ee ee eee ee oe ee ee ee on aw a on a eo ew eae oe ae ae a a eee o> ae o eee ee eo 2 ap 6 © 6 eee @ 6 6 oe Oe ee oe 4 
{Adds dependent items to subsequent |SC44 | None | 
| zones | | | 
manna nn nn nnn nnn nf nnn nnn nnn en nna nn nn nnn nnn nnn 
|Determines list of dependencies |sc39 | SCNCHN, SRCH2 | 
{from INITIAL attribute | | | 
p--—-- n= nn nn a nn nnn nnn nn nnn nnn nnn nnn nnn { 
[Determines list of dependencies |SCc4o |SCNCHN, SRCH2 | 
{from DEFINED attribute | | | 
}---------—-------------—_—-------- $----------—---- $----------—--------------------—-- : 
{Determines list of dependencies for|SC35 |EXDT, SCNCHN ie 
Jarray bound expressions | | | 
fn a nnn en nn nnn nnn pn nnn nnn nnn nnn nnn nnn nn —+ 
{Determines list of dependencies for|SC50 | SCNCHN, SRCH2 | 


|jstring length expressions | | | 
manana a nna nna an nnn nnn nf nnn nnn nnn fn nnn nnn nnn nn nnn nnn nnn nf 
|Removes independent item dictionary|SCRUB1 | None | 
jxeferences upon which items in the | | | 
[AUTOMATIC chain depend. | | | 
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Table PP1. Phase PP Routine/Subroutine Directory 





$e eee SS SSS Se ee er SS Sa ee —4 
| Rout ine/Subrout ine| Function | 
a----- +  - - = $ —- - - wo en —- 

| EXDT {Scans dimensions tables for second file statements with adjustable | 
{ | bounds. | 
| I | 
| RAO {Scans BEGIN-ENTRY for entry type 1 entries. | 
| | | 
|RA1 {Tests for end of ENTRY type 1 chain. | 
| | | 
| RAG [Creates an AUTOMATIC chain delimiter. | 
\ l | 
| RA7 [Tests for end of chain. | 
l | 
| SCNCHN {Scans current AUTOMATIC chain; determines whether reference belongs | 
| . {to it. | 
| | | | 
| SCRUBI |Removes independent item dictionary references from the stack of | 
| |dictionary references upon which items in the AUTOMATIC chain | 
| | depend. | 
| 

|sc24 |Adds ON conditions to first automatic zone. | 
1 | I 
{sc31 {Adds temporaries (type 2) and independent items to first zone. | 
{ | | 
jsc35 |Determines list of dependencies for array bound expressions. | 
| | | 
{sc39 [Determines list of dependencies from INITIAL attribute. | 
i | | 
jsc4o [Determines list of dependencies from DEFINED attribute. | 
I | | 
jscaa [Adds dependent items to subsequent zones. | 
| 

}scso [Determines list of dependencies for string length expressions. | 
| | | 
| SETCHN {Scans AUTOMATIC chain from each ENTRY type 1 entry. | 
| 

| SORCH {Sorts chain in order of dependencies; creates zone delimiter | 
| {dictionary entries. | 
| ; | 
| SRCH2 |Scans second file statements for dictionary references of labels, | 
| |data items, and structures, which may belong to the current | 
I {AUTOMATIC chains. | 
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@eTable PT. Phase PT Storage Allocation AUTOMATIC Storage 


eS Ss ee es ee ewe we eww ee ewow ees oe > oe en owe om om eee rw we Oe ee @ ee wee ee eee 


1 
|Main Processing| | 

| Statement or Operation Type | Routine | Subroutines Used | 
SM COREY chi nk RED cea) Rf enc apa ke VER SS SS AERTS GED ete OEP AOE SCY CRS RDC: Ge eS ccs 2 ED EES GD <P ae aS ae ED ee a eee ae ee 8 oe eo ere @ ee eee a ee = oo --------—] 
|Scans stacked CONTROLLED chain for |MYNAM | DVSIZE | 


llargest dope vector | | | 


------~-- 





-~—--------------------}---------------} --~------------------------------4 


|Initializes ENTRY type 1 chain scan|DSALOC |MKSTAT | 
{and DSA | | | 
aa aaa nn nnn fn nn nn nf nnn nnn nn nnn nnn nnn nnn nf 
jAllocates slots for ON conditions |DSA4 |MKSTAT | 

a nn nnn nnn nnn nn nnn a nn nn nnn nn nnn nnn en nnn 
|Allocates storage for workspace and|DSA10 | None | 
|for DSA addressing vector | | | 
Sc a a a i a rae 4 
|Scans AUTOMATIC chain and allocates|DSA16 {COPY, DVSIZE, INITDV, MKSTAT, | 
| storage .for dope vectors | | STDVIN | 
Ra nn nf nf a a { 
|Allocates BUY workspace |DSA17 | None | 
wa a a a af nn nn nn nf nnn nnn nn nn nnn nnn nnn nnn nnn anf 
|Allocates storage for parameters {| DSA19 | None | 
DAE SE ES EIT GE FUR GER COON SER Me ARGS SAR ACD re IY Sap SORTA SS AREY A RR ARMY OS AEN CD NO SD CORT GN EDS ON Sree care cma We ane IRI Ri a a en cS a SR SEP TD ee a cS Se a Ee OS CO EP ee a 4 
|Allocates storage for double |DSA25 | None | 
{precision variables | | | 
A SO DD ED Oe OS ER Ne ED EE OE EE ED AD TS ED SY ED ED a ae SP AP TD AD TS SSS OLS A Ae SS PS SSP AP LP LP ASS AS A AS TS LS AS LS A SS > PP eS SS a a PD CD > CP Sa GD 4 
|Allocates storage for single |DSA29 | None | 
|precision variables | | | 
~-------- = ---- = ~—}----------------------------------- 4 
|Allocates storage for character | DSA38 | None | 


j|stxings and halfword binary | | | 


a= ~~~ == = = = =f np nnn 


|Allocates storage for bit strings |DSA46 | None | 
lAllocates storage for arrays and |DSA54.~—~—~—=S*«{|COPY, INITDV, MKSTAT, SDVCDE i 
|secondary dope vectors | | | 
[pilscstes storage for s@ucieces [bakes ~*C‘i oc ara CCC i 
[Gets VDA and initializes dope [psa72,” [COPY, INITDV, MKSTAT, STDVIN __ 


{vectors for adjustable regions of | | 
[AUTOMATIC chain | | 


| 

| 

mann a nnn nn nnn nnn nn nnn nnn 
} 


|Allocates storage for DEFINED items|DSA98 | None 


Ba i i a a a a a ee eh ae ee a ee nh oe pe on ew 
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eTable pti. 


Phase PT Routine/Subroutine Directorv 








Aaa aaa a a i eae ely | 


|Routine/Subroutine| Function | 
jcowrt ~s* orang (enue tolless cain top aise Ge cegest Gaps wees, 1 
{ COPY |Compiles code to copy skeleton dope vector into real dope vector. 
| DSALOC [Initializes ENTRY type 1 chain scan and DSA. 
|DSA& lpeiecakes slots for ON conditions. 
|DSA5 |Allocates standard save area and flag bytes. ! 
|DSA10 ee storage and workspace for DSA addressing vector. |! 
|DSA16 inezee AUTOMATIC chain and allocates dope vectors. 
|DSA17 agoeiees BUY workspace. 
|DSA19 (PU) |Allocates storage for parameters. ! 
[DSA25 (PU) aiaeeetes storage for double precision variables. 
|DSA29 (PU)  iewtes storage for single precision variables. ! 
| [ease (PU) |Allocates storage for character strings and halfword binary. | 
|DSA46 (PU) |Allocates storage for bit strings. 
| peas iveestes storage for arrays and secondary dope vectors. 
peas |Allocates storage for structures. | 
{paa72 bpieiavices dope vectors for adjustable regions of AUTOMATIC chain. 
\DSA71 ieeeres pointer to skeleton second file statement. 
neKee ieee storage for DEFINED items. 
rneai ee inigcesese storage required for dope vectors. ! 
roaaie2 {Compiles code to initialize dope vectors. ! 
| anes |Gets VDA for this region of AUTOMATIC chain if required. | 
ee (PU) |Determines size of dope vectors. 
\iarepy [Compiles code to initialize address slot in dope vector. | 
ne |Makes a second file statement. 
| ANAM oe CONTROLLED chains. 
| sDVCDE (PU) \eoaeiiea code for secondary dope vectors. 
| STDVIN [Initializes structure member dope vectors. 
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Table QF. Phase QF Storage Allocation Prologues 


Cc SS SS Se Sees (eae eee a aa GOED GPS eee ene oe a eC eae ee SD EE OF OP OP ROE OO SOOO BOSS OTe 2a wewes = 


ae 1 
| |Main Processing| | 
: Statement or Operation Type | Routine | Subroutines Used | 
rrr rrr rn rr fr rrr rer refine mn rn nnn - - +--+ - - | 
‘|Scans text for statement labels, {QF0000 |QBEGEP, QBPROL, QEOP, QMOVE, QPROL, | 
| PROCEDURE statements, BEGIN | | QSL | 
|statements, BEGIN END statements, | | : | 
jand end-of-program marker | | | 
faa nnn nn nn nnn nnn nnn fn nn nnn nnn panne nn nnn nnn nn nnn nnn nnn nnn nn : 
| Processes statement label |QsL | QMOVE | 
|pseudo-code items | | 

~--~-----——--------—--—--------— }--------------- }+---------------------------------- + 
{Frees text storage at end of phase; |QEOP | QMOVE | 
{releases control | | | 
| ---------—-------- ~~ —-—---------} -------------- +} - +--+ == = === ---------4 


|Creates stereotyped prologue for a |QBPROL JQADJAL, QFSKIP, QF0201, QMOVE | 
|BEGIN block requiring a dynamic | | | 
{storage area | | | 
| -----------------------—-—--------}--—------—----}--------------------------------—- 

|Creates stereotyped or special | QPPROL |QADJAL, QFSKIP, QF0201, QMOVE, | 
|proloques for PROCEDURE statements, | | QONPRL | 
{depending on conditions. Processes| ‘| . | 
|statement label pseudo-code items | | | 


wa nn nnn aan nn a nf on ann nn nnn 4 
{Creates a compiler label marking | OQBEGEP . J|QADJAL, QFO201, QMOVE | 
jthe return from a BEGIN block | os | 
|Creates a prologue for ON block | QONPRL ; |QADJAL, QFSKIP, QF0O201 © | 
|Assembles code to initialize DSA | QADJAL | QMOVE1 | 


|dope vector data areas, and to | ee | 
jJallocate variable data areas | i on | 
|----------~---------------------- —}--------------} ----- +--+ = 7-4 
|Skips second file statements JQFSKIP — | None | 
{following a block heading statement| — re | | 
alee oS ee ee Oe oo ee we re ae ee ree eee we a ee eo aan eee eS 
[Obtains new buffer and chains it to|QF0201 | None ‘2. | 
{the previous one | | - | 
~+-—-~— +--+ + + ef ef ee nn -  - - —- - - 
{Moves input text being skipped from|QMOVE | None | 
jinput buffer to output buffer | | | 
|------------------------------------} ---------- =} --- = = $= 
|Moves a second file statement, | QMOVE1 | OMOVE { 
|pointed at by PAR1, to the prologue| | | 
|being generated | | | 
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Table QF1. 


jRoutine/Subroutine | 


mann nnn nf a 8 nan nn 88 nnn 2 = 


[Assembles code to initialize DSA dope vector, variable data areas, 


| QADJAL 
| 


{ 
| QBEGEP 


| QBPROL 
| 


i 

| QEOP 

| 

| OFSKIP 


1QF0000 


|GF1172 
lopaaga 
\or1215 
1QF1511 
| OMOVE 


| 
| QMOVE1 


(QG) 


(QG) 


(QG) 


| 
JQONPRL (QH) 


JQPPROL (Qc) 
| 


{ 
[QSL 


Phase QF Routine/Subroutine Directory 


Function 


jand to allocate variable data areas. 


|Creates a compiler label marking the return from a BEGIN block. 


|Creates stereotyped prologue for a BEGIN block requiring a dynamic 


[storage area. 
[Frees text storage at end of phase; releases control. 


{Skips second file statements following a PROCEDURE or BEGIN 
|statement. 


|Scans text for statement labels, PROCEDURE statements, BEGIN 
|jstatements, BEGIN END statements, and end-of-program marker. 


|Moves code to output buffer; obtains new buffer if required. 
|Tests for external procedure. 

scenes prologue for GET DSA. 

penne code to copy argument and target addresses. 
leeaes for entry points. 

{Tests end of chain. 

|Tests end of first region. 

|Extracts mapping code from second file. 

iene for storage required. 

{Removes VDA accumulator assignment code from mapping code. 
eees text from input buffer to output buffer. 

|Moves second file statement to prologue being generated. 


| 
{Creates prologue for ON block. 


|Creates stereotyped or special prologues for PROCEDURE statements, 


|depending on conditions. 


| Processes statement label pseudo-code items. 
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Table QJ. Phase QJ Storage Allocation Dynamic Storage 


- 
| |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
pon n nn nnn nnn nnn nnn nnn f= fama nnn nnn nn == { 
|General scan of text for ALLOCATE, |GS1 {|ALLOC, BUY, BUYP, FREE, TRF1. | 
|BUY and FREE statements | | | 
}-——— = = fromm nnn nan fanr nanan nnn nnn nnn nnn { 
|Allocates items not requiring dope |AL20 |ALLS, TRF2 | 
| vector | | | 
| ------~~-—----- ~~ = =~ == == -- f= + - === =f oo == === === === == + 
{Generates code to move skeleton | MOVEDV | TRF2 | 
|dope vector into workspace for | | | 
[controlled variables | ] | 
SUP SntEnT SnD TaP guDED NDE UEDEDENRINDE TP SHSERE> unk 3-051 RREREIEEETERERITeE fran n anna nn == =f 
[Looks ahead to reverse pointers for|REVPT {GS1, TRF1 | 
| ALLOCATE statements | | | 
~~~--~--~--—---------~-------------— }---------------}--~-----------------~--------------] 
JAllocates storage for controlled |AL28 |GS1, LIBC1, LIBC2, SCANSF, TRF2 | 
|string | | | 
~----=--~----------—-------------— t----------——---}-----------~-----------------------] 
|Allocate storage for controlled {AL27 | ABOUND, LIBC1, MOVEDV, PREVAL, | 
jarray | |SCANSF, TRF2 | 
~---~-~----------------—----~--- +--+ ---- ~~ ---f === + --------------------4 
{Allocates storage for controlled | AL29 {BNDEXP, LIBC1, MOVEDV, NXTREF, | 
{structure | |NXTVAR, PREVAL, SCANSF, TRF2 | 
ana na nanan nnn nn nnn nn nf nnn nan nn nn nn nnn nnn nnn nnn nf 
|Loads Library call parameter | FREE | TRF2, TRF3 | 


|xregister to free allocated storage | | | 


Ne 


|Moves skeleton dope vector for | BUYP | TRF2 | 
| bought temporary | | | 
naa == == === = == ff oan nn 
|Buys storage for temporary array {| BY14 |SCANSF, TRF2 | 
-------+- oo en ee ae ee ee ee ee ee ee ee ee ee eee eee -~4---------~---=- a ee oe ee om om SS ee or 2 ee eo Oe ee oe oe ee ee) eee ee eo oa: 
|Buys storage for temporary {BY13 | LIBC4, NXTREF, NXTVAR, SCANSF, TRF2| 
{structure | | | 
}---------—------------------------ }- - ----- —----- 4 ~~~ =~ -- ------ =f 
{Places initial value code line for |AL1i5 | NXTRF, SCANSF | 
jcontrolled variables | | | 
~-------- ~~~ === == == == === === == = $~~---—---------~---------------—--f 
|Skips scan register over | SKIPTX |GS1 | 
Jinitialization statements | | | 
| -- --—- nn nnn fn nnn nn nf nn nn nnn nn nnn nnn nn wenn nd 
{Generates code to set a pointer to |PREVAL | TRF2 | 
[the previous allocation. | | | 
me a a a ar er re es 4 


t + + 
{Searches dimension tables for | ABOUND | SCANSF | 
jadjustable bound expressions | | | 


| --—-~~—--——-------- == -- === === $f nnn nnn nnn nnn nnn 


|Generates code for temporary | STMP | LIBC3, TRF2 | 
|variables requiring only a dope | | | 
| vector | | | 
Gaia oS See ee ee ee Loses eee a ae eas J 
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Table QJ1. Phase QJ Routine/Subroutine Directory 


| Routine/Subroutine | Function 

\ABOUND (OK) [Searches dimension tables for adjustable bound expressions. 4 
pore (QK) |Ascertains the type of allocate statement. 

Pre |Places initial value code line for controlled variables. 

aa (QK) |Allocates items not requiring dope vector. 

a2? (QK) |Allocates storage for controlled arrays. 

vere (OK) |Allocates storage for controlled structures. 

hl eupene |Generates or extracts code to set the adjustable bounds of 

| | structures. 

| BUY lassextaas the type of buy. 

| BOYP limseen skeleton dope vector for bought temporary. 

lavis |Buys storage for temporary structure. 

or ae storage for temporary array. 

ae Buge storage for temporary string. 

— (QK) |Loads Library call parameter register to free allocated storage. 
a {General scan of text for ALLOCATE, BUY, and FREE statements. 
‘aca aneanaaee |Places the library calling sequence for controlled storage in 


MOVEDV (OK) 


|NXTREF (OK) 


|NXTVAR (QR) 
|PREVAL (QK) 
{Reve 
ecaned 
Venere 


| 
|STMP (QK) 
| 


| 
| TRF1 
| 
| TRE2 
i 
| TRF3 


Dae eae cee are cre ae oe eer en nen ee ee cere cow ce cee ee es ee ere ae ne ae re eee oe ee oe ae ae a a TE on ee ee a Oe OR ee a ee ae ee ee en eee ee a a en oe 


|sequence in the text. 


| 
{Generates code to move skeleton dope vector into workspace for 
|controlled variables. 


|Obtains the next structure base element reference. 

{Obtains the next varying array base element reference. 

Vepreey eae code to set a pointer to the previous allocation. 
Weekes ahead to reverse pointers for ALLOCATE statements. 

Wises second file statement in the line in the text. 

|Skips scan register over initialization statements. 

letersi code to buy storage for temporary variables which only 
{require a dope vector. 

{Transfers input text to output. 

fudge text skeletons to the output text. 


| 
{Adds the Library Calling sequence to the output text. 


Chapter 3: Flowcharts, Tables, and Routine Directories 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
! 
| 
| 
| 
l 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
1 
| 
4 


341 


@Table QU. Phase QU Alignment Processor 


epee ne et eee ee ee Me ee a eee eae aT ee ee ee 

|Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
~--------------—-------—---------- }-----—--------}----------——------------------—-4 
|Tests pseudo-code instructions for |ALIGNQ | ALREGQ, MVCMAK, REGENT 


| 
|misaligned operands and deduces the| | | 
|correct alignment | | | 


ef a fn rn nn ee 


{Generates a move character (MVC) | MVCMAK | ABEOT, NEXREG, OUTEST, PSMOVE, REMOVE, | 
jinstruction for a misaligned | | SNEXT, TRANS | 
| operand { | | 
p--—--~---—------ =~ a= fn nnn nn nnn nn ean nn nnn nnn nnn nnn nnn nn nnn nnn { 
|Skips a pseudo-code item {T3 | TNEXT | 
~--------—~-----=-~--- ~~ ------} ------------- === === == == === === ; 
|Processes the load address (LA) | TLA | TRR | 
|pseudo-code instruction | | | 
{Processes the library calling |TLTB | ABEOT,T3 | 


|sequence in the pseudo-code { | | 


pe raat ate ee ee OS a ee re eee eae 


|Processes the L pseudo-code | TLL eee ee Denes Camere none vad REMOVE, | 
{instruction | aerial TRANS, TRR | 
See aa aia GER Ey RURAL SEER ete { 
|Processes pseudo-code instructions, |THT "| ALIGNO, TRRS 


| 
jother than L and LA, that may have | | | 
|misaligned operands | . , | 
| -------------—-----—--—-__--------— fowenn nanan nnn mf aan nnn nnn nnn nnn nnd 
{Examines a pseudo-code item and | TRANS |T3, TABS, TDROP, TEOP, THT, TLA, TLIB, | 
|passes control to the appropriate | | TLL, TRR, TSN | 
[processing routine | 
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e Table QUi. Phase QU Routine/Subroutine Directory 





[Routine/Subroutine] ~~ Functions— (sts—<i=—‘—s~s~s~™S™S™~:SY 
ese eps ec ec aedeg ee 
aeons |Tests whether or not the register is in the register table. ! 
ineeane {Gets a symbolic register. 
{OUTEST tees a new output text block if required. | 
| PSMOVE | ili current output text block and gets a new one. | 
| REGENT |Makes an entry in the register table for a register that has been 
| | loaded with the address of a misaligned operand. | 
| REMOVE reseiee text into the output text block. ! 
| SNEXT inecesees next pseudo-code item in the source cents 
| TABS |Scans absolute code and copies it onto the output text if Jeceneuet 
| TDROP leeoses dropped registers from the register table. 
| TEOB jAt the end of a source text block, moves out the scanned text and : 
| {gets the next source text block. | 
eee jAt the end of the program, outputs the remaining text, and releases ! 
| |control. | 
ane |Deletes an assigned register from the register table. ! 
ies iopeet ee the statement number slot in the communications region. 
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Table QX. Phase QX Print Aggregate Length Table 


RS a a I AREAS ee, aa a a a | 
|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
~--------—---—----—---—-—-------— }-----—--------+}-~------------------—----------—-4 
|Scan storage chains in dictionary |SCANC | ANAGG, PRNTAB | 
|for aggregate entries | | | 
}-------------------------—-------—}---------------}--------------------------------— 
|Analyze aggregate dictionary | ANAGG | ANCOB, EXTENT, FINALA,FIRSTA,FORMAL, | 
jentries and print table entry | | GETVO, GETSB, MAKEN, PRHED, SORTEN, | 
| | | VOPLUS | 
Lee So eet jello Seem eee ee eo ee ee ee ed 


Table QX1. Phase QX Routine/Subroutine Directory 


a a a rn rn 7 


|aggregate entries. 


| 
SORTEN [Sorts text block entry for aggregate so that the entries are chained 
jin collating sequence order of the aggregate identifiers. 


| VOPLUS |Calculates address of first or last element of major structure. 


Li —.—— in sce cms i es cll oes “ea hws ao Ss ee ee ce oe ee ee rm ee ee ee ee oe ee a ee 9 ee ee or ee ee en 6 ee ee Pee ee ewe 


|Routine/Subroutine| Function | 
| ANAGG [Analyzes dictionary entries for a major structure or non-structured | 
vee | 

| 
| ANCOB {Finds original major structure dictionary entry for a COBOL major | 
| | structure. | 
{ | | 
| EXTENT {Calculates length in bytes of a data variable, label, task, event, | 
| jor area. | 
1 { 
| FINALA {Calculates address of final basic element of a major structure. | 
{ i 
| FIRSTA {Calculates address of first basic element of a major structure. | 
| | 
| FORMAL jCcalculates length of a non-structured array. | 
| | l 
| GETVO jGets virtual origin of a dimensioned variable. | 
I | | 
|GETSB |Sets pointer to BCD in a dictionary entry. | 
| | 
{MAKEN jMakes an entry in text block for each aggregate. | 
| | i 
| PRHED |Prints main heading and sub-heading of table. | 
| | | 
| PRNTAB |Prints Aqgregate Length Table. | 
| | | 
| SCANC {Scans STATIC, AUTOMATIC and CONTROLLED chains in dictionary for | 
| | 
| | 
i 1 
| | 
| i 

| 

i 
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@®Chart 10. Register Allocation Logical Phase Flowchart 


SESSA LSESCCSES OS EFE 


*FIRST SCAN RA SOCAL SSO SEDESE 
De ee ee oe ee te ee ee * * 
= ESTABLISH $<€2--- =e * 10A1 * 
*ADDRESSIBILITY * * ¢ 
° * THSSCETETEEEOES 


SHSSESESSEETES TERE 


SECTER1L FEOF ES EE EE 
¢ 


RD* 
ee eee eee ee 


*SET UP TABLE TO* 
S DEAL WITH EQU s¢ 
See Heeseseseeeses 


FHO0SCL ESSERE SEES 
*SECOND SCAN RF* 
t— 6- $~ 6- 8- $- 6-6-8 
* ALLOCATE * 
* PHYSICAL * 


* REGISTERS * 
COSTES ERSEEE SORES 
sae6 
*11¢ 
t->e Bi ¢ 
¢ * 
sees 


Chapter 3: Flowcharts, Tables, and Routine Directories 345 


Chart RA. Phase RA Overall Logic Diagram 
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eChart RD. 


Phase RD Overall Logic Diagram 
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Chart RF. Phase RF Overall Logic Diagram 
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Table RA. Phase RA Register Allocation Addressibility Analysis 


CS ee ee ee ee a ee Se ae at ee 1 

{Main Processing| | 
i Statement or Operation Type | Routine | Subroutines Used | 
|-----—---—---------—-- —---------——-}-----—--------} --------------------------—---—-4 
{Controls scan of source | LAA |ACT1, ACT2, ACTS, ACT8, ACTS, | 
I | |ACT10, ADCBUF, GETSBF | 
t------------—------—--—--------— {--------------- $-----—---~-------------------------- { 
{Processes RX, RS, or SI | ACT3 |ADTEST, DRTEST | 
| instructions | | | 
|-------------------—-----—---------}----------—----} -----—---------------------------4 
|Processes SS instructions {ACTS |ADTEST, DRTEST | 
|-----—----------------—---------- }-------- ~------}~----——---~------------------------ j 
|Compiles code for start of PL/I |ACT15, ACT14, |ADCBUF, GENFLP, UPSN | 
|Statement: 1. with label, 2. | ACT16 | | 
jwithout label, 3. compiler label | | | 
—----------------------——-------—-}----------—---- }~---------—---------------------—- { 
|Processes PROCEDURE and BEGIN |ACT6 | ADCBUF | 
| blocks | | | 
~----—---—---------------—----—- ~-}---------------}-—---—-- -- —---------------------4 
| Processes END statements on |ACT7 | ADCBUF | 


|PROCEDURE or BEGIN blocks | | | 


See en ee 


|Adds text to output string | ADCBUF | GETCBF | 
|Adds text to insertion file | ADIBUF | GETIBF | 
----- ~~ $e ——---—-—— —}-----—---- —— ——- -- = = 4 
{Obtains new source buffer | GETSBF | None | 

----—---—---------—--——-------- $----------—--- -}-----—---—-—--------------------- { 
[Obtains next output buffer | GETCBF | None | 
wa nnn nnn nnn nnn nnn nn an nn nnn nn nn 
{Obtains next insertion file buffer |GETIBF | None | 
|-----—----_~-------------------—} -------------} ------------ —------------------ = j 
{Examines dictionary reference in |DRTEST |ADINST, DECOMP, SETBLK | 
| source | | | 
wanna n= $$ nn nnn fn nnn nn nnn nn 
|Produces recovery code when literal|ADTEST | ADCBUF | 
joffset greater than 4095 is met | | | 
}---------—---—------- ——-------—--- ---------------} -----—---------------------—----—- 
jCreates coded addressing | ADINST | ADCBUF, ADIBUF | 
{instructions | | I 
a ee ee SE tle ee eens J 
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Table RA1. Phase RA Routine/Subroutine Directory 


ween $e pa eee + 5 + + + +--+} 


| Routine/Subroutine | Function | 
ma nan fn nnn nn a { 
J|ACT1 |Copies non-special three-byte item to output. 
|ACT2 |Copies non-special five-byte item to output. 


| 

| 

| 

jJACT3 | Processes RX, RS, or SI instructions. | 
inca ececeuees SS instructions. | 
JACTS [End of block routine. | 
JACT6 Seuaweeeas PROCEDURE and BEGIN blocks. 
{ACT7 peosceeee END statements on PROCEDURE or BEGIN blocks. 
{ACTS | md of source text routine. | 
| ACTS jAction of start of common block of prologue. 
| ACT10 {Action at end of prologue. ! 
Gr |Copies absolute code to output stream. | 
eee |Creates ADI instruction at prologue insertion point. 
‘xoria Compiles code for start of PL/I statement with label. 
neris ieoaees code for start of PL/I statement without label. 
ae |Compiles code for start of PL/I statement compiler label. 
yore aes store of calculated address. 
beens aaa text to output string. | 
| ADIBUF [Adds text to insertion file. 
| ,DINST ieeesees coded addressing instructions. | 
lapeeee |Froduces recovery code when literal offset greater than 4095 is pete 
er jTests whether previous offset is out of bounds. ! 
TeECOME |Decodes dictionary reference. ! 
tpereet (RB) jExamines dictionary reference in source. 
lone {Scans step table and generates addressing instructions. 
bcenent |Generates code to set bits on and off in a prefix ON-slot. 
ieneee [Obtains next output buffer. | 
| CETIBF lobeatus next insertion file buffer. | 
| (ETSOF jObtains next source buffer. 
ox aeeae input text. 
112.25 |Moves addressing instructions to IN-LINE. 
| SETBLK ieinae block number of referenced item. 
| UPSN {Generates code to keep the statenent number slot in the DSA up to ! 
| | date. | 
hae et do ) 


@Table RD. Phase RD Use Determination of all EQUs 

aaa a aaa aaa a a RE 

|Main Processing| i 
| Statement or Operation Type. | Routine | Subroutines Used | 
q-—~~—-~-—-- --- ---------=---- == -- —f ---- == $f $n nnn nnn nn 
{Initializes text blocks for tables |LINIT | None | 
~---~----—---~----—--- —-- ~~~ -- f= -- +--+ === + +--+ ------- === 
|Scans text | LBUILD |LEQV, LBC, LBAL, LOBR, LEOB, | 
| | |LABS, L3BYT, LSBYT, LVARB, | 
| | | LSTAT, L2BYT, LEOP | 


| -----—--——- ~~ -- —-- = f+ nn nn nnn nnn nnn nnn nn =o 4 
[Processes EQU items | LEQU | FNDIND | 
ie re rn er fe ee ee ce ee ee ee ee ee ee ee me Oe ee ee ee ee ae oe ee { 
|Processes BC items | LBC | FNDIND | 
aa nnn nnn nn fn nf nnn nnn en 4 


|Processes BAL items | LBAL {|LOBR, LSOBYT | 


NER EET EE TEED CETTE DERE 


| Processes any other branch item | LOBR | FNDIND | 


= : + = 
[Skips a 2-byte item | L2BYT | Non | 


mew ww a ne en rn 
|Skips a 3-byte item | L3BYT | None | 
~--------—------~--—-----—-------- $--------—-----}----------—-----------------------| 


{Skips a 5-byte item | LSBYT | None | 
mn nn nnn nnn nn nnn nh nnn nn an nnn nnd 
|Skips a variable length item | LVARB | None | 

~~-~—---~——------—---}---------------}} =~ -- === === : 
| Processes a statement number item |LSTAT | None | 
aan nna enn nn nnn ap nnn nn nnn 
|Processes an EOB item | LEOB | None | 
man = nf np nn nnn nnn nnn nnn nd 
|Scans absolute code | LABS | None | 
wa nnn na nf pan nn nnn nn nn nnn 
|Finds the indicator byte and text |FNDIND | None | 
|xeference of an EQU value | | | 
---------—--------—-————----—- —}------------ === = =f 
jEnds table build and passes control|LEOP | LSCAN | 
[to second section | | | 





-----—--—-——----—---—-—----— }---------------}-----—----------------------------- { 


{Scans tables for optimizable EQUs {LSCAN {| LFLAG | | 


Se eo 


|Flags EQUs in text as optimizable |LFLAG | None | 
Sa eee Cee ee epee ror ent age eed eR 1 etme meee ae eee eee aoe aaa ) 
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® Table RD1. 


Phase RD Routine/Subroutine Directory 


Ot rr nt rr rant rn rn 71 


| Routine/Subroutine | Function 
mim * Aetade indicator byte ana text ceferencecof Ego yaiue’°=~=~C~S~SCS*S 
pans poe absolute code 

perc {Process BAL items 

epe nee BC items 

EeeLED {Scans text 

eon | peedeises EOB items 

jieee jEnds table build and passes control to second section 
| LEQU lieenantée EQU items 

| LFLAG vies EQUs in text as optimizable 

awe lanleustiees text blocks for tables 

tome ‘ Sieteases any other branch item 

| LSCAN aaa tables for optimizable EQUs 

fore |Processes statement number items 

| LVARB |Skips variable length items 

anes iaeipe 2-byte items : 

ane |Skips 3-byte items 

[nspyr. Isrs 5~byte items 
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Table RF. Phase RF Register Allocation Physical Registers 

Cre eng eg eR ee red pe Te ge re ea eee ee a ee aarti 
[Main Processing] | 

| Statement or Operation Type | Routine | Subroutines Used 


Controls scan of text 


\z9 |ADCBUF, ADIMOV, BR1, BR3, BR4, i 
| |GETNXT, LBAL, LBALR, LBCTR, LEOB, | 
| |LEOP, LR1, LR3, LR4Y, LR6, LR7, LR, | 
| |LSHIFT, OBREGS \ 


-----—---—------~-—-- —----—}- ------------4----- = --- === ----------—------- { 








[Processes PROCEDURE or BEGIN | LPROC | None | 
j statement | | | 

—--——--—-------- —--- ——--—--- -- 4 -- -- + - + --} -—- ---- - — — —- +--+ +--+ ++ 
| Processes end of PROCEDURE or BEGIN|LEND | None | 
| block | | { 
[}---—-—-- nn nnn nn nnn wn wenn nnn nnn nnn 
|Processes requests for registers; |OBREGS | BRGUSE, LOAD1, STORE1, STORE2, | 
jJallocates physical registers | | REGUSE | 
a a ee ee, 
{Compiles code to store symbolic | STORE2 | ADCBUF | 
|xregisters | | | 
———--=—— ~~ nn cr { 
|Compiles code to store assigned | STORE1 | ADCBUF | 
|registers | | | 
mn nr rane 
{Compiles load of physical registers|LOAD1 | ADCBUF | 
|Compiles load register | LOADRG | ADCBUF | 
fp ma ren panna nnn nnn nnn 
|Expands coded addressing | ADIMOV | ADCBUF | 
jinstructions | | { 
fan a rn rc cs ween 
{Adds to output buffer | ADCBUF | None { 
8 a a ee a eh ee ed 


Table RF1. Phase RF Routine/Subroutine Directory 


[Routine/Subroutine| = | Function ‘| 
na —s iM toot hace. CCC" 
| pawoy tee coded addressing instructions. 
| naguas |Tabulates use of base register in look-ahead. ! 
ea (RH) s Beecesgee RX branch instructions. 
| aa (RH) {Processes BCT instructions. | 
|BR& (RH) ‘ eceeaees RR branch instructions. 
| FRTEST on list of free registers to make even-odd pair. 
comer pores next block. 
|LAD1 (RH) teeebeswes AD1 (addressing) instructions. ! 
[np (RH) [constructs and puts out completed instruction. 
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Table RF1. 


Phase RF Routine/Subroutine Directory (cont'd) 


jRoutine/Subroutine | 


Function 


rr rt rn + ff 


{LBAL (RH) 
eae (RB) 
wet (RH) 
poe (RH) 
eae (RH) 
aoe (RH) 
nace 
ere 
iPonDRe 
epRoe (RH) 


| 
[LR1 (RH) 


| 
|LR3 (RH) 


{ 
JLR4 (RH) 


{ 
JLR6 (RH) 
| 


| 
JLR7 (RB) 


| 
[LR (RA) 
| 


‘ieurae (RH) 
teaeeo Oe) 

| 68630 (RG) 
| 3895 (RG) 
‘Sona (RH) 
iounEes (RG) 
‘pucuae 
pon 
letones 

an (RB) 


i 
}Z9 (RH) 


bn ee ee ee 
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| Processes 


ieobesede 
| Processes 
| Processes 
ieeaae end 
| Processes 


| Processes 


BAL instructions. 

BALR instructions. 

BCTR instructions. 

DROP pseudo-instruction. 

Of PROCEDURE or BEGIN block. 
end-of~block marker. 


end-of-program marker. 


{Compiles load of physical registers. 


{Compiles load register. 


| Processes 


| Processes 


PROCEDURE or BEGIN statement. 


instructions in which first and second operands require 


jloading, and the first is altered, e.g., AR. 


| Processes 


| Processes 


floating-point instructions. 


SS instructions. 


{Processes instructions where a load of first operand is required, no 


joperands are changed, e.g., ST. 


| Processes 


| Processes 
jand it is 


| Processes 


SI instructions. 


instructions in which no load of first operand is needed, 


changed, e.g., LA. 


shift instructions. 


j|Tests whether all registers are available. 


|Generates 
Weenuesese 
‘isd text 
| Processes 


| 
jTabulates 
| 


stores of registers if branch in or out. 

code to load registers. 

scan. 

requests for registers; allocates physical registers. 


use of registers in look ahead. 


|Compiles code to store assigned registers. 


j|Compiles code to store symbolic registers. 


| 
|Fxtracts ADIs at prologue insertion point. 


|controlling scan of text. 


doe en nn a ee = we re en ee re rn ne 
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Chart TF. Phase TF Overall Logic Diagram 
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Table TF. 


Phase TF Final Assembly Pass 1 


Ge egg Gps ngs We a or ty ee Oe eg Ne ee gage ig ee pawn wie ea pea pO ne ee Sa ee gn ae ge 7 


|Main Processing| 


| Statement or Operation Type | Routine | Subroutines Used 
| ---~---------------—------------- =} +--+ -----------f ------- --- === -------------------- 
{Scans text {1L0024 | None 
~-~~~----—---------=-=-=----------- }--~--~---------}------------~----------------------| 
{Assigns offsets to labels |IL0019 | FINEQ1, NEXTSL 
}-~--------------------- —-------- — }------------ +=} ---- === == 5 === === === == === == 
{Increments location counter for {IL0014 | None 
[machine instructions | | 
|---------—-----=---<------- = ---- - + -------------- }~------------------------------- 
j|Determines code for instructions {IL0020 | FINEQ1 
{which refer to labels | { 
wee ne ee en a ee 4--------~------} -- - -- -- +--+ + - +--+ + 
{Initializes location counter at |1L0010 | None 
jstart of procedure | | 
rece ae cle es eli area eee eee tenet as 4$-~----~~-~--~~--}~+-------------+---- +--+ ---~+ +--+ 
{Stores size of procedure and {21L0011 | None 
jxresumes containing procedure | 
Table TF1. Phase TF Routine/Subroutine Directory 
ee es ee ee ee ee ee ed 
| Routine/Subrout ine | Function 
~--~---~-~------}---- ~~ ---- ---- ---- === ~~~ == 5 === $$ $f 
| FINEQ1 |Locates label number table entries. 
1 | 
| IL0000 {Entry point from compiler control. 
| 
| IL0003 {Entry point to scan from initialization routine. 
{ i 
{| I1L0010 {Initializes location counter at start of procedure. 
{ 
}IL0011 |Stores size of procedure and resumes containing procedure. 
{ | 
{IL0014 | Increments location counter for machine instructions. 
{ | 
{IL0015 | Processes the start of prologues. 
l { 
{IL0017 |Releases control. 
| | 
{IL0019 {Assigns offsets to labels. 
1 | 
{IL0020 - }Determines code for instructions which refer to labels. 
| 
{1L0022 {Processes end-of-block pseudo-code item. 
| l 
|ILO024 |Scans text. 
NEXTSL [Determines multiple statement label entries in dictionary. 


| 
L 


} 
| 
| 
| 
| 
| 
I 
| 
: 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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Table TJ. Phase TJ Final Assembly Optimization 


Se are ee pe er ee ee ee fee or We ey tee ee a ree 1 

|Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
~---------------------------------- }~--------------}-----------------------------------4 
{Controls phase | 1L0000 | OPTIMA . | 
aa n= 2-2 = = $= == 2 $f nnn nf nnn nnn nn nnn nnn 
|Maintains location counter for {| IL0014 | None | 


jmachine instructions | | | 


}---------------------~-------------}---------------}-----------------------------------4 


|Assigns offsets to labels |IL0019 |COMRTN, FINEQ1, NEXTSL | 
panna n= | poo aE $------ tenn nnn nnn n nnn nnn nnn onan { 
{Determines code for instructions | 1L0020 | FINEQ1 | 
jwhich refer to labels | | | 
-~--------—--—--------------------- }--------------- }----------------------------------- { 
[Initialize location counter at | 1L0010 | None | 
[start of procedure | | | 
~---------—--=--------------------- }--------------- }----------------------------------- { 
|Stores size of procedure for | IL0011 | None | 
|machine instructions | | | 
IEpLpH re AUSGUIEIOg UP NDUnESD> nD SEDUESIENSET EP REDEEED 95-9“ fan nnn nnn nnn nnn nnn} 
|Reduces number of MVC instructions |1IL0027 | OFFSET, OSMRTN | 
| —--—- nan nn nnn a nnn nnn nnn nnn nn nn nnn nnn nnn 
{Determines offset from a given | OFFSET | None | 


{dictionary reference | | | 


i a a cc es ec ets as es ee ae es ee a ees ies A ee eo es ee a ee es re ee bh ee ee ee er re es wes ea ee eee S 


Table TJ1. Phase TJ Routine/Subroutine Directory 
(oe ee ay pe a nee ee ee Sey) er es en eT eT weg 1 
| | 


Routine/Subroutine Function | 
[COMRTN. ~+~«([Determines whether further optimization is possible. } 
ened hsesces label number table entries. ! 
coda reereis phase. ! 
| IL0003 re point to scan loop from initialization. ! 
{| IL0010 {Initializes location counter at start of procedure. ! 
|1L0011 ioeebes size of procedure and resumes containing procedure. 
| IL0012 ipeeesuees timaachine instructions, etc. 
|IL0014 ‘eaaeeaee location counter for machine instructions. 
aeoots |Assians offsets to labels. 
| IL0020 |Determines code for instructions which refer to labels. | 
eorret eee pseudo-code item length and updates text pointer. 
ener | ginaee MVc instructions. 
{1L1001 |Evaluates new ADCON needs. Sets location counter to zero. ! 
]21L1101 taeateees content of containing procedure. ! 
iaeenge Hiosks for equivalent statement labels. | 
[OFFSET (TK) {Determines offset from a given dictionary reference. : 
t opTIMA : ieeahe text. | 
ieee [scans ahead for literal offsets. 
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Table TO. Phase TO Final Assembly External Symbol earn 


| {Main Processing] | 


| Statement or Operation Type | Routine | Subroutines Used | 
SSS 7a TRS em CS CPT LPR PGE EE we ga ea, 
jConstructs first six standard FSD |LG&01 |MOVE, NAME, ERROR | 
jentries | | | 

~--------—--------—---—---------—- }--------------- }----------------------------------- ; 
{Constructs entries for external |LG001 | MOVE, ERROR | 
jprocedure labels | | | 

a nnn nnn nnn nn nnn nnn nnn nn nnn finn nnn nn nn nnn nnn nnn nnn nnn nnn 
{Constructs PR type entries for each|LG030 |MOVE, NAME | 
{block and procedure | | | 
fn See { 
{Constructs entries for external | LGO50 | MOVE, ERROR | 
|variables and external entry names | | | 

wa ae an ann nn a nn nf on nn nnn nnn nnn ne nnn nnn nnn nnn nnn 
{Constructs entries for controlled |LG090 |MOVE, NAME, ERROR | 
|variables and task names | | | 
fan a nn fr rn nn i nn nN : 
{Constructs entries for Library | IL0200 | LHEINC | 
| conversion modules | | | 
eee a eee ee Be ie ayia ale ee i J 


Table TO1. Phase TO Routine/Subroutine Directory 


(S939 36 SS KT LP SS SS SS A A SS SD SS A SS ES SINE SY SS SS OS SS eS ST ED SE SO eee A SS SS SS RE OO US EE OU kD ES ES OS eS ee Oe ee ee OS ee 


[ ROUT1NE/ SUBROUTINE ] FUNCTION | 
[ERROR | Teancates ever Wencth eacemial idenvitier, Generates accor message. | 
{| LG001 jConstructs entries for external procedure labels. 
{ LG030 {Constructs PR type entries for each block and procedure. 
| 1G050 ecneevaces entries for external variables and external entry names. : 
|LG055 erstesss ON-conditions and external variables. ! 
| LGO080 Peceuaees external entry names. | 
|LG085 ees FILE constants. 
|1G090 tcouseraces entries for controlled variables and task names. ! 
fe ieee name in ESD entry for CONTROLLED. 
{| LG401 feces first six standard ESD entries. : 
| MOVE [Moves ESD entries to card buffers, and puts out buffer when full. | 
| NAME Veeneeaese names for pseudo-registers. | 
i TaeINe (TQ) icone eee a string of Library module names. 
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Table TT. Phase TT Final Assembly Pass 2 


ee re See 2 ie ieee Cina aia aR a aa a a or 3) 

[Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
}--~--------------------—----------- }--------~------}~--~-----~------------------------- { 
|Scans text | IL0002 | None | 
}---------—-~~-----—---—------—-—— }---------------}----------------------------------- 4 
|Generates text for RR instructions |IL0012 | GENTXT | 
}---------------~--------—-~-~ == ~~} -- == ---- += = 7-5 <= $= == 5-2-2 ---------- === -4 
{Generates Text for RX non-branch — |1IL0013 | EOBRTN, GENTXT, OFFSET | 
jinstructions LM, STM, and SI Types | | | 
| -—— ~—nn nn n nn pn nnn nnn fan nm nnn nnnnan { 
|Generates text for shift | 1L0027 | GENTXT | 
|instructions | | | 
}~---------—-----~----------------~-}-----~---------} ---------- = -----------------------+4 
{Generates Text for SS instructions |IL0014 | EOBRTN, GENTXT, OFFSET | 
---------------------------------— }---------------}----=-------—---------------------| 
{Sets up trace information and | IL0019 | GENTXT | 


|mumbers compiler labels | | | 


}-----------------------------------}----~----------} -----------------------------------4 


|Generates text for branch and load |IL0020 | FINEQ1, GENTXT, OFFSET | 
jaddress instructions | { | 
fa rr a eae : 
{Initializes location counter at | IL0010 | PUNCHT | 
[start of procedure | | | 
p+ nnn nnn $o---==---~-- fn nnn nnn : 
{Resumes containing procedure at end]|IL0011 | PUNCHT | 
{of procedure | | | 
fe a el 
|Moves Text into card image | GENTXT | PUNCHT | 
[---------—--------- = fp nan nnn nnn nn nnn nnn nnn nn nnd 
|Punches cards ensuring that RLD | PUNCHT | CARDOU | 


jcards foliow related TXT card | | | 


| ------~--—------------------------} -- ~~~ - --- - = - $f 


|Generates text for compiler | INCLUD | GENTXT | 
{subroutine | | | 


Lo. ee ee ee ee Le ee ee I 
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Table TT1. Phase TT Routine/Subroutine Directory 


| Routine/Subroutine | 


Function 


a= ~~~ —--- === =f =~ = nnn 2 nnn == 888 === === =f 


| CARDOU 
fone 
| FINEO1 
jonni 
| 20002 
| £0003 
| 50010 
irpooda 
| 70022 


| 
| 1L0013 
| 


{10014 
| 40015 
1enooae 
| 10017 
| 0019 
| 10020 
IL0022 
L0027 


|] PUNCET 


FFSET (TU) 


{Directs card image to load file or punch file. 
[Chains to next input text block. 

|Locates label number table entries. 

| 


|Moves text into card image. 


| 
|Scans text. 
| 


jEntry point to scan from initialization routines. 
[Initializes location counter at start of procedure. 
iebewese containing procedure at end of procedure. 
(rise text for RR instructions. 


|Generates text for RX non-branch branch instructions, LM, STM, and 
|SI type. 


|Generates text for SS instructions. 

| Processes the start of prologues. 

ioeokeenes the end of prologues. 

| End-of-text routine. 

|Sets up trace information and numbers compiler labels. 
|Generates text for branch and load address instructions. 
waver ies routine. 


{Generates text for shift instructions. 


jDetermines offset and relocation pointer from given dictionary 
|xéference. 


| Punches cards ensuring tnat RLD cards follow related TXT card. 
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Table UA. Phase UA Final Assembly Initial Values, Pass i 
a a ca a ag ag ae sara Me ee a ee ey ae ee ee ae ,] 
|: |Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used ] 
ST UEpEpUEEpoah=p una SOUP SEER NEP SUPE IEDUEP SURE a So>>O Eee Dep eemEe reat ermine 
{Scans STATIC chain to beginning of |UA001 }UA200, UA220, UA230 | 
Jexternal section | | | 
sr aaa see 
JInitializes scalar variables | UA200 | TXTMOV | 
| -----------------------—-—-------—- f+ ------- == +--+} 5-5-2 + === === === === =f 
|Initializes BCD for label {UA220 | RLDMOV, TXTMOV | 
wo nnn nn nn fn mn nnn nnn nn nnn nnn nnn nnn nnn nnn 
jInitializes DED for temporary | 0A230 | TXTMOV | 


a 4------~-——--—- - -- } - -- - +--+ - +--+ 


j 
[Initializes address constants. |UA010 }UAS01, UAS03, VA4YO4, UA4OS, UAKOE | 


f + + 
|Initializes symbol table entries {UA080 |RLDMOV, TXTMOV | 


Ne 


|Initializes address slots for | UA403 | RLDMOV, TXTMOV | 
jexternal variables | | | 
mann anna nn nn nnn enna nnn np nn nnn nnn nnn nnn nnn nnn nnd 
|Initializes address slots for | UA40O1 |RLDMOV, TXTMOV | 
| functions and programmer-defined | | | 
{ON-condition names | | | 
wa nnn nn ann an nna fon nnn nf nnn nnn nnn 
{Initializes address slots for label|UA404 |RLDMOV, TXTMOV | 
jconstants | | | 
we nr ef omen: wan nn nf 
jInitializes address slots for entry|UA405 |RLDMOV, TXTMOV | 
{labeis | | | 
}--------------------------------- —-}------------- =f == == nn 
‘Initializes file attribute entries |UA406 |RLDMOV, TXTMOV | 
Jand files a | | | 


wana nnn nn nn af nn nnn nn nf nnn nn nnn nnn nnn nnd 
|Initializes constants pool | UA014 | RLDMOV, TXTMOV . | 
a A CC a SOY A EE TR EY WE RN ANGE AY SS MND ORS EE PRR eee SNRIN CeO) SERED SMR ETSY Ew meme cate SMR AS he ne CONE AD teams SC RD CANE noe SEES AU Seen ate AEOEY GRA SITS ee So EE A Se Se ee ee ee ee Se ee | 


{Initializes dope vector skeletons |UA021 | TXTMOV . | 
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Table UA1. 


Phase UA Routine/Subroutine Directory 


|Routine/Subroutine| oo Bnetion 1 
jooreor (ue). |Moves Gard images to punch and/or'icad flies ==SSC~SCSCSCtCSC 
eeugy (UB) {Moves RLD entries to card buffer. 
{TXTMOV (UB) eee TXT entries to card buffer 
erry eee point from compiler control. 
tuxood taeaea STATIC chain to start of external section, to initialize 
| |scalar variables. | 
| ya0018 {Return point for branches taken in first scan. ! 
| vaon0 [Initializes address constants. 
rere {Return point for branches taken in second scan. 
ano (uc) | Initializes constents pool. 
ronoai [Initializes dope vector skeletons. 
| 0215 (UC) | Produces text for dope vector skeleton. 
1 eaoes JInitializes argument lists. 
es ues point for branches taken in last scan. 
one (uc) ieee caaaees symbol table entries. 
| A100 (UC) ‘rabesatiees one-word CSECT ‘IHEMAIN‘. 
ranoon |Exit from UA to compiler control and UD. ! 
VaaoO0 |Initializes scalar variables. ! 
err (uc) {Initializes BCD for label. ! 
ere (Uc) JEntry to label routines for label variable ECDs. ! 
aise (UC) biaveieiieee DED and FED for temporary. 
| DA401 {Initializes address slots for functions and programmer-defined 
| {ON-condition names. | 
loaeo3 anteteiiees address slots for external variables. 
eer ehiciatisss address slots for label constants. ! 
aauoe {Initializes address slots for entry labels. 
‘anes miedanives DECLARE control blocks for files and file attributes 
| jentries. | 
| vas07 when text for file attributes entry. 
aerate (uc) |Initializes array variables. ! 
luetous (uc) |Initializes arrays of varying strings. 
| uc0080 (uc) {Initializes bit arrays. 
|nxpy (UC) Leche ened packing of bit strings in structures or arrays. 7 
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Table UD. Phase UD Final Assembly Pseudo-Code Static DSA's 


CC ee wee en oe wae ow oe a Se» we we oe ee Oo we en ee we wi we i ee 


7 
| {Main Processing| | 
| Statement or Operation Type | Routine | Subroutines Used | 
|---------—------------——---------- }--—------------} +--+ - -- == == == === === === +f 
{Scans STATIC DSA chain JA1 | AUTO | 

~-~~~--- ~~~ = --- === ~~ ~~ ===} +--+ =f 22 ne $= === === 4 
{Scans STATIC DSA's AUTOMATIC chain |AUTO | DAT, LAB, STRUC | 
|---~-----—--------------—-------—- fo nana annem fren n ann nnn nnn nnn nnn nnn { 
{Initializes dope vectors for data |DATLAB | TXTMOV(UB) , RLDMOV (UB) | 
{items and label variables | | | 
| (unstructured) | | | 
[Initializes dope vectors for | STRUC | TXTMOV (UB) , TLDMOV (UB) | 
| structures | | | 
bo ee ee bo ee ee een ae ene ees ee eh a re eee ee ae we ee ee ee ee ee ee J 


Table UD1. Phase UD Routine/Subroutine Directory 


| Routine/Subroutine| Function { 
_ leeace orangeiben chain 
nono cue STATIC DSAs AUTOMATIC chain. | 
| DATLAB [Initializes dope vectors for data items and labels. | 
| STRUC JInitializes structure dope vectors. 
Tagan jones point ! 
EN [Releases control. 
bee we ee er nh a ar ee ee nn en mere ne ene enn en en een ne eee = 
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Table UF. Phase UE Final Assembly Initial Values, Pass 2 


ae en tee eT ee ee eS ae fe ee eg ea a 1 
{Main Processing| | 


| Statement or Operation Type | Routine | Subroutines Used | 


4 
{Scans STATIC chain to beginning of |UA001 |UA200, UA220, UA230 | 
{external section | | | 


Ne a Orr 


[Initializes scalar variables | UA200 | TXTMOV (UB) | 
{Scans STATIC chain to initialize | VA003 |UA300, UA320, UA340, UA360, UA365 | 
jinternal dope vectors | | | 
anna ~ == === = === = $= = $= = foo fan 2-2 === === === 4 
jInitializes dope vectors for | UA300 | RLDMOV (UB), TXTMOV (UB) | 


Jinternal strings | | | 


aa nnn nn nnn nnn nnn nn nn a pn nnn nn ap ann nnn nnn nnn nnn nnn nnn nnn nnd 


|Initializes dope vectors for | VA320 |RLDMOV (UB), TXTMOV (UR) | 
janternal data arrays | | | 
[SS 5 SIRNA Ria aa 1 SR SRE SR aC RSPR a ES ae ea 4 
JInitializes dope vectors for arrays|UA340 |TXTMOV (UB), UCUPDT (UC) | 
Jof varying strings | | | 
aa nn $f nnn nf nnn nn === - === === === +f 
{Initializes dope vectors for | UA360 |RLDMOV (UB), TXTMOV (UR) | 


jinternal label arrays | | | 


+ + 
[Initializes dope vectors for |SA365 |UA300, UA320, UA360 | 
Jinternal structures | | | 


~~ ~- = == - = == == = = = = fn nn nf nn nn nnn nnn 


|Initializes arrays | JA030 |RLDMOV (UB), TXTMOV (UB), { 
| | JUCINIT (UC) | 
~--------— ++ + --- = - - + fe + - 
[Initializes structures |UA04O | TXTMOV (UB), UA200, UCO800 (UC), | 
| | |TIDY (UC) | 
}-------------------—-------------—-}-----—---------} -----—---- —-----------------------4 
| Initializes one word CSECT |UA100 | OUTPUT, RLDMOV, TXTMOV (all in UB) | 
| "IHEMAIN' | | | 
-------------—----~+-~-—~----- --~--- 4 +--+ + +--+ 
jInitializes CSECT for STATIC {UA1005 {OUTPUT (UB), UA030, UA200, UA300, | 
jexternal variables | |UA320, UA360, UA365, UA4O1, UAHOE | 
}------------------------- = ----- ~~ =f on nn nnn nnn nn nnn nnn nnd 
[Makes up END card and terminates |UA120 [OUTPUT (UB)- | 
| phase i : | 
{Initializes array variables JUCINIT (UC) {| TXTMOV (UB), UCO080 (UC), TIDY (UC) | 


Low LL ee 
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Table UER1. Phase UE Routine/Subroutine Directory 


[Routine/Subroutine] = +: Function ————s—~CSS 1 
ma aiaaee eyes” 
oe JInitializes EVENT variables. 
ae jInitilizes TASK variables. 
vee ees point from UA and compiler control. 
oRoea Neeeee STATIC chain to start of external section, to initialize ! 
| {scalar variables. | 
ronoods ene point for branches taken in first scan. 
| ua0o3 \ecaue STATIC chain to initialize all dope vectors for internal 
| | variables. | 
ae iene of scan for arrays and structures. | 
freer ibieiaviees arrays. 
eked ee RLD entry for label array virtual origin. 
cre ieoenen point for branches taken in array scan. ! 
panos iesdukes RLD entry for data array virtual origin. : 
ore aad lattes structures. ! 
ey. (UC) avcisiaees IHEMAIN CSECT. | 
aes ea point for branches taken in external scan. ! 
eer eee up END card and terminates phase. 
pon eied staat scalar variables. 
 GaseF ieee label variables. | 
1 ona06 iaicisiieed dope vectors for internal strings. 
ruKaso laa edetiess dope vectors for internal data arrays. | 
rere Rarities dope vectors for arrays of varying strings. | 
rere heattiertees dope vectors for internal label arrays. | 
| 0UA365 areaniees dope vectors for internal structures. ! 
| UA4O1 rabeiniiwes address slots for functions and programmer-defined | 
| {|ON-condition names. | 
lanuee lauieieinees DECLAPE control blocks for files and file attributes 
| j entries | 
|0a1005 lagietaiiges CSECTs for STATIC external variables. 
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he a ae we a a ee ee on wr rw re 


Table UF. Phase UF Final Assembly Object Listing 


|Main Processing] | 


| Statement or Operation Type | Routine | Subroutines Used | 
scans Text ==SS*S*~*~S~S*S*S~«s ROO lone SSSCS~CSTE 
[tists RR instructions ~~*(z0012.~”~«<U PRIWTT, RRRIN~~~—~SC~S~S~S~&Y 
{Lasts RX non-branch instructions {110013 {BXRIN, PRINIT, PRNTOU, PRUTVF, | 
l | | SECOND | 
[Lists SS instructions [1L0014 CS |EOBRTN, PRINIT, PRNTOU, SSRTN | 
[Lists shift instructions {rL0026 ~‘|PRINIT, PRNTOU, PRNIVF 
[Lists LM and SM = =©——~<C—~stsC“Cts~‘C:«~SLOTCC( SCS” {PRINET, PRNTOU, PRNTVF, SECOND | 


an nn nn ff ee + + + + + - + - | 


[Lists SI instructions | IL0028 |CHARVF, PRINIT, PRNTOU, PRNTVF l 
| i | SECOND, SSRTN | 


AOE A AS AS A A SA A SS A SS SS AS SS TSS aie EAS Ghee SOND GERAD SEND SPD GES GD GD OS SAGES SND SEED GENS Ey GN GE SE SY GED SD SD SD SE SD GEARS TD CUED NP ate GS GD a SD aD ES ES ED SED cee en ee See DD 


{Lists branch and load address | IL0020 | IL0013, NAMEIT, NAMEQU, PRINIT, | 
jinstructions | | RRRTN | 
aa --~---- ~~ --- = $= + fn $f nnn ne anna === === 
{Lists labels | IL0019 | NAMEVF, NEXTEL, NEXTSL, | 
{ | |PRNTLC, PRNTOU, PRNTVF, STATMN | 
-----------—----- - -- - ——- -- ~—- - - -- -- - - - f+ a nf a rn ene 
|Lists procedure names | IL0010 | NAMEVF, NEXTEL, PRNTOU, STATMN | 
p---~-----—---—- = -- - == = = fo nf ian nnn nnn nnn nnn nnn nnn nf 
{Lists ends of procedures | 1L0011 | NAMEVF, NEXTEL, PRNTOU | 
}--~---~------—----- = ------ =~ == -- ff a nnn nn nnn nnn nnn nnn nnn nnd 
{Scans ahead for literal offsets; | SECOND | EOBRTN | 


Jinserts second instruction byte | | | 
jinto print image | | | 


~~~ == == $= nf of nnn nnn nnn nnn nnn nnn 
{Generates listing of text for base |SSRTN, BXRTN | ABSOFF, ADDEND, NAMEIT, NAMEQU, | 
joffset pair | | PRNTVF | 
|---------—--------- -------------- -- f= =~ =f en nnn nnn nnn nnn 
|Names generated label number | NAMEQU |DECINT, FINEQ1 | 
wa naan a ann nnn nn aah nn nan nna nnn nnn nnn nn nnn nnn 
jInserts location counter value, and|PRINIT | PRNTL | 


|hexadecimal and mnemonic operation | | | 
{codes in print line | | | 


4 + : 
{Moves variable length item into | PRNTVF | PRNTOU | 
[variable field part of print line | | | 


wo a + fe fe ne + | 


{Lists statement numbers | STATMN | STATNO | 
| -----~~--—----------- == -- == -- f= =~ + fp a nan nnn nnn nnn nnn nnd 
{Determines name and offset from | NAMEIT | DECINT, HEXINT | 
|dictionary reference | | | 
~-~------—------------—=-------— $--------------- }-----—----------------------------- : 
{Generate listing of compiler {IL0017 | PRNTLC, PRNTVF, PRNTOU | 
| subroutine | | | 
eRe een ee See ae eC ee See OEE Lo GeN a  mER RP REN PRCN I a a pee en 4 
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aa UF1. 


| ABSOFF 


| 
| ADDEND 


1 BXRTN/SSRIN 


loHARVE 
a 
oon 
ead 
eee 
weer 
Pete 
| 10003 
errr 
layoodd 
aoe 
| 10013 
quoi 
ore 
| pr0016 
| 0017 
eee 
eas 
nous 
re 
| 10027 
| n002e 
eerie 
Vanes 
| 22005 
| MANES 
Nae 
NAMES 


| 
| NEXTEL 
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(UG) 


(UG) 


(UG) 


(UG) 


(UG) 


(UI) 


(UG) 


(UG) 


Phase UF Ee eye ee Directory 


|Appends literal offsets to operands in variabie part of print line. 
| 

|Appends signed literal offsets to operands. 

| 


|Generate listing of text for base offset pair. 

| 

{Places one character in variable field of print line image. 
| 


{Converts binary to externally coded decimal. 


| 
{Chains to next input block. 


| 
|Locates label number table entries. 


{Converts binary to externally coded hexadecimal. 


{Entry point from compiler control. 


{Scans text. 


|Entry to scan from initialization routines. 


{Lists procedure names. 
Lists ends of procedures. 
Pp 


{Lists RR instructions. 


{Lists RX non-branch instructions. 


{Lists SS instructions. 


|Processes the start of prologues. 


incocetees the end of prologues. 

| End-of-text routine, and compiler subroutine listinc. 
jProcesses compiler generated label numbers. 

levees labels. 

{Lists branch and load address instructions. 

{Lists shift instructions. 


| 
{Lists LM and ST™. 


{Lists SI instructions. 

ieeedoseae SS decimal instructions. 

ne "*PROCEDURE" followed by entry names and statement number. 
{Identifies operands. | | 
|Detexrmin2s name and offset from dictionary entry. 
eee generated label number. | 

jPlaces a variable name in the print line. 


| 
[keene dictionary for multiple entry labels. 


Table UF1. Phase UF koutine/Subroutine Directory (cont'd) 


[Routine/Subroutine| SS — Bunction i 
metre (bey (penne dictions) foe mui pie cestauenc tebe 
‘aao00s (UH) cnet return point in naming routine. | 
pore (UG) | eae location counter value, hexadecimal, and mnemonic op codes. | 
puna (UG) j|Converts location ementer to hexadecimal; places it in print image. | 
jeRwiee (UG) pee a line. | 
leRaiie (UG) used variable length item into variable field part of print line. | 
teens resnceaess RR format listing of text. | | 
\eEGonn |Scans ahead for literal offsets; inserts second instruction byte 
| jinto print image. | 
eee (UG) |Lists statement numbers. 
iaieaae (UG) {Converts statement number to decimal. 


nn a ce ene ee me cr a ce cn ee a es re cn cre a ee ne ce ee ae ae is cee ee ea ee me ee ee ee ae ae ee a ee ee ae we oe ee oe ee ee 
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Table XA. Phase XA Error Message Editor 


A a Ra a a, EC a et eS ee eee ea 1 
i |Main Processing] | 
| Statement or Operation Type | Routine | Subroutines Used | 
wa a nf fo ee 4 
|Determines whether error messages |XA | None | 
jare to be printed | | | 
~--—-----—- --- --- +--+ - - + + --- -- f - + f -- - - +-+ --- ------f 
|Scans error message text skeletons |XA8 |XA50, XA70, XA90, XA110, ZUPL | 
jand prints. them out | | | 
Bi a a a i a ie a a i al 


Table XA1l. Phase XA Routine/Subroutine directory 


(Ot rr tet rn etry 


Jjmoves it to print buffer. 


XA90 (XB) {Converts binary numeric value to character representation and moves 
jit to print buffer. 


XA110 (XB) |Moves identifier from dictionary entry to the print area. 


| Routine/Subroutine| Function | 
| -----—------~----- |} —-- ~~ + nn nn nn nn nnn nn nnn nnn nnn 
| XA |Determines whether error messages are to be printed. | 
| | 

| XAO0 |Sets severity code. | 
| | 

|XA01 {Establishes which message types to suppress. | 
| | 

| XA1 {Counts number of error chains to be processed. | 
| 

| XA2 jPuts out messages if there are no diagnostics. | 
| 

| XA4& {Prints out “COMPILER DIAGNOSTIC MESSAGES". | 
| 

| XA7 |First scan of message chains. | 
| | 

| XA8 {Scans error message text skeletons and prints them. | 
| | | 
|XA9 (XB) {Scans to head of next non-empty chain. | 
| 

| XA12A j|Selects and prints header for messages of given severity. | 
| | 

|XA30 (XB) {Gets next entry in message chain. | 
| { . | 
|XA32 (XB) |Builds up first part of message in buffer. | 
| 

|XA35 (XB) | Accesses message skeleton. | 
| | | 

|XA4O (XB) {Puts out completed message. | 
| | 

{XA50 (XB) ‘|Moves message text to print buffer. | 
| | 

|XA70 (XB) {Converts binary statement number to character representation, and | 
| 

| 

| 

| 

| 

| 

| 

| 


| 
| ZUPL {Prints a line on SYSPRINT data set. 
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This appendix relates the logical 
phases, physical phases, and modules 
contained within the physical phases. The 
compiler name is IEMAA. 


PHYSICAL 
PHASE MODULES 


Compiler Control 
AA 


AB 


AC 


Bb 


AG 


B 


B 


AT 


BX 


F1 


DESCRIPTION 


Controls running of 
compiler 


Performs detailed 
initialization 


Writes records on 
intermediate file 
SYSUT3 


Performs inter-phase 
dumping as specified in 
the DUMP option 


End of read-in phase 


Controls system 
generation compiler 
options 


Closes SYSUT3 for 
output, reopens for 
input 


Format annotated 
dictionary dump 


Format annotated text 
dump 


Closing phase of 
compiler 


Controls extended 
dictionary compilation 


Phase marking 


Controls normal 
dictionary compilation 


Carries out extra 
debugging during 
compiler runs 


48-character set 
preprocessor 


Checks whether Syntax 
Check should terminate 
compilation 


BC 


BG 


BM 


BW 


JZ 


AS 


AV 


BC, BE, BF 


BG, BL, BJ 


BM, BN 


BO, BV 
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Builds second half 
phase directory 


ee ES ES SREY SCTE CEE 


Resident phase for 
compile-time processor 


Initialization phase 
for compile-time 
processor 


Initial scan and 
translation phase for 
compile-time processor 


Final scan and 
replacement phase for 
compile-time processor 


Error message printout 
phase 


Contain the diagnostic 
messages 


Cleanup phase for 
compile-time processor 


Read-In Logical Phase 


cI 


CL 


co 


cs 


CV 


CA 


cc 


CE 
CG,CI 
CK 
CL,CM 
CN 
CO,CP 
CR 
CSs,CT 


CV,CW 


Read-In phase common 
routines 


Read-In phase common 
routines 


Keyword tables 
Read-In first pass 
Keyword tables 
Read-In second pass 
Keyword tables 
Read-In third pass 
Keyword tables 
Read-In fourth pass 


Read-In fifth pass 


Dictionary Logical Phase 


ED 


EG 


ED 


EF,EG 


Initialization, 
subroutine package for 
Declare Pass 2 


Initialization 
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PHYSICAL 
PHASE 


EI 


EL 


EP 


EW 


EY 


FA 


FE 


FI 


FK 


FO 


FQ 


FT 


FV 


FX 


MODULES 


EH, EI, EJ 


EK, EL, EM 


EP 


EV, EW: 


EX,EY,EZ 


FA, FB 


FE, FF 


FI 


FO, FP 


FQ 


FT, FU 


FV,FW 


FX, FY, FZ 


DESCRIPTION 


First pass over DECLARE 
statements 


Second pass over 
DECLARE statements 


Constructs dictionary 
entries for PROCEDURE, 
ENTRY and CALL 
statements > 


Constructs dictionary 
entries for LIKE 
attributes 


Constructs dictionary 
entries for ALLOCATE 
and for explicitly 
qualified based 
variables. 


Checks context of 
source text 


Changes BCD to 
dictionary references 


Checks validity of 
dictionary references 


Rearranges attributes 


Constructs dictionary 
entries for 
ON-conditions 


Checks validity of 
PICTURE chain for PL/I 
functions and the 
TRANSLATE and VERIFY 
functions 


Dictionary 
hous e-keeping 


Merges second file 
statements into text 


Processes identifiers 
for cross reference and 
attribute listing 


Pretranslator Logical Phase 


GA 


GB 


GK 
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GA 


GB,GC 


GK 


Constructs DECLARE and 
OPEN control blocks 


Modifies I/O statements 


Checks parameter 
matching 


GO 


“GP 


GU 
HF 
HK 


HP 


GO 


GP,GQ,GR 


GU,GV 


HF, HG 


HK, HL 


HP 


Preprocessor for second 
check on parameters 


Second check on 
parameters 


Processes CHECK 
condition statements 


Processes structure 
assignments 


Processes array 
assignments 


Processes items defined 
using iSUBs 


Translator Logical Phase 


IA 


IG 


IK 


IL 


IM 


IT 


Ix 


JD 


IA,IB,IC 


IG 


IK 


IL 


IM, IN, IP, 


TQ 


IX 


JD 


‘Stacks operators and 


operands 


Processes array and 
structure arguments and 
built-in functions 


First part of 
preprocessor for 
generic functions 


Second part of 
preprocessor for 
generic functions 


Processes generic 
functions 


Processes function 
triples 


POINTER and AREA 
checking 


Evaluates constant 
expressions 


Aggregates Logical Phase 


JI 


Jr 


JK 


JP 


JI,JJ 


JI,JK,JL 


JK,JL,JM 


JP 


Structure 
pre-preprocessor 


Structure preprocessor 
Structure processor 


Checks DEFINED chains 


Optimization Logical Phase 


KA 


KC 


KA, KB 


Kc, KC1 


Table handling and 
initialization 


DO temporaries 


PHYSICAL 
PHASE 


KE 
KG 
KJ 
KN 


KO 


KT 


KU 


MODULES 


KE, KE1 
KG, KG1 
KJ 
KN 


KO, KP, KQ 


KT 


KU, KV 


DESCRIPTION 

DO MAP build 

DO examine 

SUBS TABLE build 
Initialization 


Subscript optimization 
1 and 2 


SCAN utility 


Merge patches and loop 
control 


Pseudo-Code Logical _Phase 


LB 


LD 


LR 


LS 


LV 


LW 


LX 


MG 


MI 


LB, LC 


LD 


LG, LH 


LS, LT, LU 


LV 


LW 


LX, LY 


MB,MC 


MG, MH 


MI, MJ 


Generates triples to 
initialize AUTOMATIC 
and CONTROLLED scalar 
variables 


Constructs dictionary 
entries for initialized 
STATIC scalar variables 
and arrays 


Expands DO loops 


Fixed decimal 
expression optimization 
and initialization for 
phase LS 


Converts expression 
triples to pseudo-code 


Provides string 
handling facilities 


Initialization for 
phase LX 


Converts string triples 
to pseudo-code 


Constructs pseudo-code 
for functions 


Constructs pseudo-code 
for pseudo-variables 


Scans for ADDR and 
STRING functions and 
generates code for each 


Constructs pseudo-code 
for in-line functions 


Constructs pseudo-code 
for in-line functions 


Constructs pseudo-code 
for in-line functions 


MK 


ML 


MP 


NA 


NG 


NJ 


NM 


NT 


NU 


OB 


OD 


OE 


OM 


OP 


os 


MK 


ML 


MM, MN, MO 


MP 


MS, MT 


NA 


NG 


NJ, NK 


NM, NN 


NT 


NU, NV 


OB, OC 


OD, OE, OF 


OG, OH, OL, 
or 


OM, ON, 0O 


OP, OO 


OSs, OT, OU 


Constructs pseudo-code 
for in-line functions 


Processes generic entry 
names 


Processes CALL and 
function procedure 
invocations 


Reorders BUY and SELL 
statements 


Constructs pseudo-code 
for subscripts 


Generates pseudo-code 
for branches, RETURN 
triples, etc. 


Generates Library 
calling sequences for 
DELAY and DISPLAY 
statements 


Generates Library 
calling sequences for 
executable 

RECORD-ori ented 
input/output statements 


Generates Library 
calling sequences for 
executable 
STREAM-oriented 
input/output statements 


Pre-processor for NU 


Generates Library 
calling sequences for 
data/format lists 


Processes compiler 
functions and 
pseudo-variables 


Pseudo-code assignment 


Constructs Pseudo-code 
for assignments 


Generates library 
calling sequences 


Generates pseudo-code 
for data type 
conversions in-line 


Generates pseudo-code 
for further in-line 
conversions 


Converts constants to 
required internal form 
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PHYSICAL 


PHASE MODULES 


DESCRIPTION 


Storage Allocation Logical Phase 


PA PA 

PD PD 

PH PH 

PL PL, PM 
{PP PP,PO 
PT PT,PU,PV 
QF QF,QG,QH 
QJ QJ,QK,OL 
QU Qu 

Qx Qx 


Puts eligible DSA‘s 
into STATIC 


First STATIC storage 
allocation phase 


Second STATIC storage 
allocation phase 


Constructs symbol 


tables and DEDs 
Sorts AUTOMATIC chain 


Allocates AUTOMATIC 
storage 


Constructs prologues 


Allocates DYNAMIC 
storage 


Aligns misaligned 
operands and processes 
halfword binary 
operands 


Lists lengths of 
aggregates 


Register Allocation Logical Phase 


RA RA, RB, RC 
RD RD 
RF RF,RG,RH 
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Processes addressing 
mechanisms 


Flags branches for 
optimization 


Allocates physical 
registers 


Final Assembly Logical Phase 


TF 


TJ 


TO 


TT 


UA 


UD 


UE 


UF 


UI 


XA 


TF 


TJ, TK 


TO,TP,TQ 


TT, TU 


UA, UB, UC 


UD,UB,UC 


UE, UB, UC 


UF ,UG, UH 


ULI, UG, UH 


' Error Editor 


XA 


XA, XB 


XA, XC 


XxF 


XG, YY 


Assembly first pass 


Optimization 


Produces ESD cards 
Assembly second pass 


Final assembly initial 
values, first pass 


Generates RLD and TXT 
cards to set up dope 
vectors for STATIC DSAs 


Final assembly initial 
values, second pass 


Produces listings 


Completes final 
assembly listings 


Determines whether 
there are diagnostic 
messages to be printed 


Constructs the third 
phase list 


Controls the printing 
of messages 


Message address blocks 


Contain the diagnostic 
messages 





10M ON 00 





[OP_0Q 
OS OT OU 
CE CG Cl PA PD 
ck CL CM | PH 
CN CO CP PL OPM 
hee POPP 
cs cr PT PU PV 
leas _QF QG OH 
QJ QK al 
Qu 
OX 
/ RA RB_RC 
-RD 
{RF RG AH 
atte TF 
: iT. 





% REPRESENTS COMPILER DEBUGGING ROUTINES ,AD,AH,Al,AJ OR AT, 
WHICH MAY BE IN PERMANENT RESIDENCE IF REQUESTED 


@Figure 7. PL/I Phase-in-Storage Map 


In this phase-in-storage map, modules on This map represents the ‘worst' case, 
the same horizontal line may be in storage does not always reflect the order of 
together. Modules on the same vertical loading. . 
line can never be in storage together. 


and 
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APPENDIX B: RESIDENT TABLES 


There are three resident tables: the 
dictionary, the keyword tables, and the 
phase directory. The dictionary is 
resident through part of the compilation; 
the formats of the dictionary entries are 
fully described in Appendix C. The keyword 
tables are resident during the read-in 
logical phase, and the phase directory 
throughout the compilation. 


ORGANIZATION OF KEYWORD TABLES 


The read-in phase is divided into five 
passes containing the modules shown in 
Figure 8. 


Modules CA and CC contain routines which 
are common to all five passes. Successive 
blocks of routines overlay the areas used 
in the first pass by modules CE, CG, and 
CI. The keyword tables are held in 
separate modules (CE, CK, CN, and CR) which 
must each be less than 1,024 bytes (1K) 


long. In this way it is possible to hold 
in storage only those keywords which are 
required for any one pass. The keyword 
tables are constructed in the following 
manner. 


For ease of searching and modifying a 
keyword table, it is organized into two 
levels and by keyword length, as shown in 
Figure 9. 


The KEYWD routine is called by one of 
the statement scanning routines, and is 
supplied with a parameter which enables it 
to decide which set of keywords to look at 
(e.g., Statement identifier, ON condition, 
miscellaneous). It does this by using the 
parameter to extract the required relative 
address (R(A),etc.) from the first level 
directory. The second level directory 
provides the KEYWD routine with the means 
of reaching a table containing keywords of 
correct length; the KEYWD routine calls the 
KEYID routine, which scans the next 
Significant item in the source text to 
obtain the length used in this look-up. 


4 
 Pateeanetememnen Bi | 
{ { | 
| CA | i 
| t | 
L —-—— — J > Common Routines 
| 
Sanaa + | 
| cc 1 | 
Csseei es 4 | 
Jj 
= SS 
| | | | 
 careneteieamieted 9 Lo eterno captain Ha GAM feceteteteneten | eer 1 
| CE i tot CK i It 4 CN it ot CR i tol CR | 
eee ee aero 5 a eens OS I eres I MO cr J  &-------- r) 
| | | 
°-------—- 1 | ees, 7 | cacncereieneten 1 (--- oo 1  Paceecaieeed 1 
| ee | i tol it | i t st | 
1 ce | | | ch | | | CO FY | | cS FT TJ cv | 
| i I i I ol 1! st i tol | 
eae oe J] tee j j -------1 | ee eee | j}  &-—-------3 
! : | | 
SS 1 | een 7 seared, | 4 oS 4 
| i I J i tt it ol i; tl | 
| cI i tot CM 1 t{ {t cP i tf cr { | | CW | 
| it ot i t 4 i t | it 1 | 
ee Se oe ee ee ee 4 | t--------4 fj  t-------- J 
| | | | 
Pass 1 | Pass 2 | Pass 3 | Pass 4 | Pass 5 
Figure 8. Organization of Read-In Phase 
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ee 
| ceeementataieaabetemated —-{ R(A) | 
| -----—j| First Level 
| r-i1 R(B) | Directory 
| | --—---—4 
| |} | R(C) --y 
{ beet. 
| 11 i | 
| 1 i | 
| | | 
\ | l 
[press eee oe 1 
At>| | B&>| | c&>| | Second 
b-———-{ f----—-4 F----—-{_ Level 
{ { i | | | Direc- 
f--—---4 -----—-4_—_ F---—-{ tory 
| { I | | | 
t-----$ ff f---—-4 
| { I | 
f----—-1 | | 
{ | 
t----—4 
| | 
| | 
Figure 9. Organization of Keyword Table 


Format of First Level Directory 


FSTLVL DC AL2(STATID ~- FSTLVL) 


DC AL2(ONID - FSTLVL) 


Format of Second Level Directory 


The second level tables contain relative 
addresses, which enable the KEYWD routine 
to reference a third level table containing 
keywords of the correct length. If one of 
these entries should contain zero, then 
KEYWD will interpret this as meaning that 
no keywords of this length exist in this 
table. 


STATID DC FL2'm* where m is smallest 
length in table 


DC FL2‘'n’ where n is largest 
length in table 


DC AL2(STLm-STATID) 


DC AL2(STLn-STATID) where the 
s ls beginning STL are 
the symbolic addresses of 
the corresponding keyword 
tables 


Format of Third Level Tables 


The third level tables have a prefix byte 
containing the number of entries in this 
particular table followed by keyword 
entries. These consist of the keyword in 
internal code plus the replacement 
character (keywords recognised as such are 
replaced by a single code byte). 


STLm DC FLi'x' where x is number of 
keywords in this table 


DC X*112315* keyword in internal 
code 


DC X*55* replacement in internal 
code 


DC X*393839' 


Dc X"SA* 


Some keywords are not represented by one 
word (e.g., GO TO, BY NAME) and clearly, 
the mechanism must be modified to cope with 
the second word. This modification is 
achieved by placing a 1-bit into the first 
bit of the first level by using the OR 
logical operation. The presence or absence 
of this bit is tested by the KEYWD routine 
before the suspected keyword is compared. 
If the bit is absent, the pass through the 
routine is quick, as there is no 
possibility of:an extra level search. If 
the bit is present, the keyword must be 
compared after the additional bit has been 
removed by the AND logical operation. If 
the comparison is equal, the two bytes 
following the replacement character are 
used as a relative address to reach the 
next level table. 


Format of Entry Requiring Additional 
Comparisons 


DC X*9726" GO + X*1000* 


pc x*4S0* 


DC AL2(N XTLVL-*) Relative address 
of next level table 


The format of these extra level tables 
is similar to that for the third level. In 
this way, it is possible for national 
language keywords to replace single words 
by two or more words, if so desired. 
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PHASE DIRECTORY 


Because of the number of phases in the 
compiler, the phase directory is split into 
halves. The first half is constructed 
during the initialization of the compiler; 
also a list of names of the phases in the 
second half is kept in Phase AA. This list 
is used to pass status indications (i.e., 
whether phases are wanted or not wanted) 
from the first half to the second half. 
Phase JZ uses the list to construct a new 
directory for the second half. 


The phase directory is constructed by 
use of the BLDL macro and a build list. 
The format of the build list is fully 
described in the publication IBM System/360 
Operating System, Supervisor and Data 
Management Services. 


Each entry in the build list is 30 bytes 
long. On returning from the BLDL macro, 
two bytes of the name field and ten other 
bytes of each satisfied entry in the build 


list are used to construct a 12-byte phase © 


directory entry in the compiler control 
routines. The build list is destroyed 
after the initialization process is 
complete. 
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The format of a phase directory entry is 
as follows: 


a a Naan —=4 
|Byte Number | Description | 


ane eae ane ee evens eas even annem am Pee eee ee ae eee enn nd 


Oo-1 Phase name | 
Status byte 


Concatenation number and 
library identification 


| 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| TTR of first text record; | 
| where TT is the relative | 
| track number, and R is the | 
| block number on that track. | 
| After the phase is loaded, | 
| these bytes contain the | 
| absolute address of the. | 
| begining of the phase. | 
| | 
| | 
| | 
| | 
| | 
4 


Total amount of storage 
required 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| Length of first text record 
tax 


This appendix describes the formats of 


dictionary entries during the compilation 


of a source program. The appendix is 
organized in the following manner: 


1. Dictionary Entry Code Bytes 


2. Dictionary Entries for ENTRY Points 


3. Code Bytes for ENTRY Dictionary 
Entries 


4. Dictionary Entries for DATA, LABEL, 


and STRUCTURE Items 


5. Code Bytes for DATA, LABEL, and 
STRUCTURE Dictionary Entries 


6. Format of Variable Information 


7. Other Dictionary Entries 


8. Dimension table 


9. Dictionary Entries for Initial Values 


1. DICTIONARY ENTRY CODE BYTES 


APPENDIX C: INTERNAL FORMATS OF DICTIONARY ENTRIES 





First Half Byte 
Bit Bit 


Position Value Meaning 

0 0 entry has BCD 
1 entry has no BCD 

1* 0 entry is to be chained 
1 entry not to be chained 

2 0 not a member of structure 
1 member of structure 

3 0 not dimensioned 
1 dimensioned 


*This bit only applies to Phase FT which 
constructs the storage class chains by a 
sequential scan of the dictionary; later in 
the compiler, items with this bit on are 
added to the storage class chains. 


Second Half Byte 


In the: second half byte, the following 
codes have the meanings shown, unless the 
first half byte is x‘'C!: 


X'7* means label variable 

X'c* means task identifier 
X'D' means event variable 
X‘°E" means structure 

X'F' means data variable 


The second and third bytes of every 
dictionary entry contain the length, in 
bytes, of the entry. If the entry has BCD 
(i.e., the first bit of the entry is zero), 
this length count does not include the BCD; 
instead, the BCD, which follows the main 
body of the entry, is preceded by a single 
byte containing one less than the number of 
characters of BCD. 


The dictionary is used to communicate a 
complete description of every element of 
the source program, the compiled object 
program, and the compiler diagnostic 
messages between phases of the compiler; 
the text describes the operations to be 
carried out on the elements. 


Each type of element has a 


characteristic dictionary entry, which is 
identified by a code occupying the first 


byte of the entry. 


In general, each type 


of element has a different code byte, but 
in order to permit rapid identification of 
dictionary entries, the code bytes have 
been allocated on the following basis: 


Appendix C: 


Using this general scheme, the code 
bytes allocated for dictionary entries 


appear in the following table. 


Code bytes 


in the table which have no corresponding 
description are not allocated. 


X*'00* Statement label constant 
01 Procedure or entry label 
02 GENERIC entry label 
03 External entry label (entry type 4) 
04 Built-in function, e.g., DATE 


05 


06 
07 
08 
09 


Temporary variable and controlled 
allocation workspace 

Built-in GENERIC label, e.g., SIN 
Label variable 

File constant 
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OA 
0B 
oc 
OD 
OE 
OF 


10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
1A 
1B 
ic 
1D 
1 
1F 


20 
21 
22 


24 
25 
26 
27 
28 
29 
2A 
2B 
2c 


2E 
2F 


30 
31 


33 
34 
35 
36 
37 


38 
39 
3A 
3B 
3c 


3D 


3E 
3F 


40 
41 
42 
43 
44 
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Task identifier 
Event variable 


Data variables (not dimensioned or a 
structure member) 


Dimensioned label variable 


Dimensioned task identifier 
Dimensioned event variable 


Dimensioned data variable 


Label variable in structure 


Task identifier in structure 
Event variable in structure 
Structure item 

Data variable in structure 


Dimensioned and structured label 
variable 


Dimensioned task identifier in 
structure 

Dimensioned event variable in 
structure 

Dimensioned structure item 
Dimensioned and structured data 
variable 


Formal parameter type 1 


4&5 
46 
47 
48 
49 
4A 
4B 
4c 
4D 
4E 
uF 


80 
81 


82 
83 
84 


86 
87 


88 
89 


8A 
8B 
8c 
8D 
8E 
8F 


90 
91 
92 
93 
94 
95 
96 
97 


98 
99 
9A 
9B 
9C 


9D 


9E 
oF 


AO 
Al 
A2 
A3 
A4u 
A5 
A6 
AT 
A8 
A9 


AC 


ON CONDITION entry 


ENTRY type 1 -- from a PROCEDURE 
statement 

BEGIN statement entries -- entry 
type 1 

ENTRY statement -- entry type 1 
Entry type 5 

Entry type 3 

Entry type 2 

Entry type 6 

Label variable formal parameter or 
temporary 

Constant 

File formal parameter or file 


temporary 
Task identifier formal parameter 
Event variable formal parameter 


Data variable formal parameter or 
temporary 


Invocation count dictionary entry 


Dimensioned variable formal parameter 
or temporary 
File attribute entry 


Dimensioned task identifier formal 
parameter 
Dimensioned event variable formal 
parameter 


Dimensioned data variable formal 
parameter or dimensioned temporary 


Structured label variable temporary 


Structured task identifier temporary 


BE 


BF 


co 
C2 
C3 


c5 
C6 


c8 
c9 


CB 
cc 


cD 


CF 


Structured event variable temporary 
Temporary or formal parameter 
structure 

Structured data variable temporary 


Dimensioned and structured label 
variable temporary 


Dimensioned and structured task 
identifier temporary 
Dimensioned and structured event 
variable temporary 

Dimensioned structure formal 
parameter or temporary 
Dimensioned and structured data 
variable temporary 


String dope vector for temporary 

DED2 entry 

Internal library functiun, e.g., 
conversion routines 

Compiler label 

Prefix ON list item 

Parameter lists 

Dope vector skeletons 

Symbol table entry or DED entry 
Error message, table entry, workspace 
requirement, STATIC DSA, etc. 

Record dope vector (RDV) entry 
Workspace requirement entry 

Select a member from a generic family 
AUTOMATIC chain delimiter or Dope 
Vector Descriptor (DVD) entry 

ON condition entry 

Label BCD entry 

End of information in dictionary 
block 


2. DICTIONARY ENTRIES FOR ENTRY POINTS 


Entry type 1 for PROCEDURE, BEGIN, and 
ENTRY statements 


The format of an entry for a PROCEDURE 
statement is as follows: 


Byte Number Description 


1 Code byte X*80° 
2-3 Length 
4 Level 


10-11 


12-13 


14-15 
16-17 
18-19 


20-21 


22-23 


24-25 


26-28 


29-31 


32-34 


35-37 


38-40 


- 
| 


bee com 


Count 


Dictionary reference to the 
entry type 1 of the 
containing block 


Dictionary reference of the 
dictionary entry for the 
first label that was 
attached to the PROCEDURE 
statement 


Dictionary reference to the 
entry type 1 of the next 
PROCEDURE or BEGIN statement 
in the source program 


The start of the chain of 
all AUTOMATIC variables 


Dictionary references to 
three dictionary entries 
indicating storage require- 
ments for workspace 


Dictionary reference of 
CHECK list set by phase FO. 


Phase QU re-uses this slot 
and sets it to the offset 
from register 9, at which 
the register allocator 
workspace is to start. 


Dictionary reference of 
NOCHECK list 


Dictionary reference of the 
first symbol table entry for 
this block 


Size of the DSA for this 
block, set in storage 
allocator phase 


Note: Phase MA moves, into 
bytes 27 and 28, the 
dictionary reference of a 
temporary describing a table 
to be built at execution 
time for the TRANSLATE or 
VERIFY function. 


Offset of the eight words in 
the DSA used for addressing 
the DSA 


Offset of the storage used 
for the parameter list 
necessary in an ALLOCATE~ 
FREE statement 


Offset of the two-byte 
Switch which is set on entry 
to a procedure and tested at 
a RETURN (expression) 


Offset of the four-byte slot 
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which will contain the 
address of the first 
approximation of the target 
field (the address of the 
implied parameter) 
41-42 Dictionary reference of the 
entry type 1 of the first 
ENTRY statement of the 
procedure. The entry type 1 
for PROCEDURE and ENTRY 
statements of any one proce- 
dure form a circular chain. 
If there are no ENTRY state- 
ments in a procedure this 
slot will contain the dic- 
tionary reference of the 
PROCEDURE's entry type 1, 
iee., Of the entry in which 
the slot occurs 
43 OPTIONS code byte 
44-57 Eight 2-byte dictionary 
references to dictionary 
entries for prefix options. 
Only those prefix options 
which are changed within the 
procedure have a dictionary 
reference. The remainder 
are zero. The order of the 
options in this list is the 
same aS in the options byte. 
(See “Options Code Byte" in 
Section 3 below) 


60 Options change byte. This 
byte contains a one bit for 
each prefix option which is 
changed within the proce- 
dure. Its format is identi- 
cal with the normal options 
byte 

61-63 Offset of workspace used in 

BUY statement 


64 Optimization byte 


65 2*n where n is the number of 
parameters at this entry 
point 


66 onwards N dictionary references of 
formal parameter type 1 
entries 


The format of an entry for a BEGIN 
statement is similar to the above for the 
first 34 bytes. The initial code byte is 
X'81", and the dictionary reference in 
bytes 8 and 9 is that of the first label on 
the original BEGIN statement, if any. If 
there was no statement label, then the 
statement number occupies this slot. The 
presence of a statement number or statement 
label is indicated by a flag byte in 
position 35. This is set to SN fora 
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statement number, or to SL for a statement 
label. Bytes 36-56 contain the same as 
bytes 44-64 in a PROCEDURE entry type 1. 


The format for the entry type 1 derived 
from an ENTRY statement is as follows: 


Byte Number Description 
1 Code byte xX'82' 
2~3 Length 
4 Level 
5 Count 
6-7 Dictionary reference of the 
_ next member in the circular 
PROCEDURE-ENTRY chain 
8-9 Dictionary reference of the 
dictionary entry for the 
first label on the original 
ENTRY statement 
10-12 The offset of the apparent 
entry point 
13 2*#n where n is the number of 


parameters 


14 onwards n dictionary references to 
the formal parameter type i 
entries 


The labels on a PROCEDURE or ENTRY 
statement will be placed in the dictionary 
according to the following format: 


Byte Number Description 


1 Code byte x‘'01' 

2-3 Length 

4-5 Hash chain(STATIC chain) 
6-8 Pointer to transfer vector 
9-10 Statement number. If the 


label is mentioned in an ON 
CHECK list, this slot 
contains the dictionary 
reference of Label BCD Entry 
(X*°CE'), which has the 
statement number in bytes 4 
and 5 


11 Other 1 code byte. (See 
"First code byte - other 1” 
in Section 5 below.) The 
last bit will always be set 
to one, unless the label is 
the last label for a 
particular statement, in 
which case the last bit will 
be set to zero. 


12-13 Pointer to entry type 2 


14-16 Spare bytes for final 
assembly. 
phase dealing with RETURN 
(expression) will insert 
into these bytes a code 
which must be stored in a 
specific slot in the DSA 
whenever the procedure is 
entered via this label. 


The pseudo-code _ 


The 


3. for strings of adjustable 
length, the text 
reference of a second 
file statement giving the 
expression for the string 
length 

13-14 Picture table reference, if 
required. The storage allo- 
cation phase will change 
this to the dictionary 


code is used by the prologue . 


construction phase. Byte 16 
in the first label for each 

PROCEDURE or ENTRY statement 
will contain the number of 


reference of a DED entry, 
the picture table reference 
being moved into this refer- 
ence if necessary 


labels associated with that 


statement 
17 Block level 


.18 Block count 


19 Count of containing block > 


Ent e 3 


Entry type 3 dictionary entries are 
constructed either from an explicit 
declaration or from implicit and default 
rules. Their format is as follows: 


20 BCD length-1 


21 


Entry Type 2 


BCD of label 


An entry type 2 describes the data 


attributes of an re point. 


is as follows: 


The format 


Byte Number Description 

1 Code byte X"'85'. 

2-3 Length. 

4-5 Dictionary reference of 
entry type 3 

6-8 offset, i.e., the position 
of the string dope vector in 
the DSA of the block to 
which the entry belongs. 
This will be zero if the 
item is not a string. 

9 DATA byte (see “DATA Byte"* 
in Section 5 below). 

10-12 Data information, which is: 


1. with numeric data, the 
precision and scaling, 
left justified 

2. for strings of fixed 
maximum length, the 
binary version of the . 
string length in the two 
leftmost bytes of the 
data information 
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Byte Number 
1 


2-3 
4-5 


6-7 


8-10 


11 


12-13 


14-15 
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Description 
Code byte X'84’ 
Length of entry. 


Dictionary reference of 
entry type 1 of PROCEDURE or 
ENTRY statement. 


Dictionary reference of 
entry type 2. This 
describes the value returned 
when the label associated 
with this entry type 3 is 
invoked as a function. 


The offset in the DSA of the 
containing block of the 
first approximation of the 
storage for the value 
returned by this entry 
point, when it is invoked as 
a function. 


The entry code byte. (See 
“Entry Code Byte" in Section 
3 below) 


The dictionary reference of 
an item in the AUTOMATIC 
chain of the containing 
block. Entry type 3 entries 
feature in the AUTOMATIC 
chain of the containing 
block. 


Switch bytes. The pseudo- 
code phase dealing with 
RETURN (expression) inserts 
into these bytes the bit 
pattern of the code which 
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16-17 


18-19 


20 


21 


22 onwards 


22+2n- 
2342n 


will signify that entry to 
the procedure was by the 
label associated with this 
particular entry type 3. 
Phase QF will use this to 
create MVI instructions. 


Dictionary reference of a 
SETS list. This will be 
zero if the attribute SETS 
was not specified. The 
format of a SETS list is 
given at the end of this 
section. 


Dictionary reference of the 
dictionary entry for the 
label belonging to this 
entry type 3. 


Status byte. This byte will 
contain X‘00° or X‘'FO‘. 
X°00* indicates that the 
entry was constructed from 
an ENTRY declaration which 
had parameter descriptions. 


-X"FO* indicates the entry 


was constructed either arti- 
ficially or from an ENTRY 
declaration which did not 
have parameter descriptions. 


2#n where n is the number of 
parameters. This is zero if 
the status byte is X'FF' 


If the status byte is xX‘'00° 
there are n two-byte 
references of parameter 
descriptions. A parameter 
description is a dictionary 
entry for the particular 
type of item but without a 
BCD. If one particular 
parameter is not described, 
i.e. if there are two 
adjacent commas in the ENTRY 
attribute, then the 
dictionary reference is 
zero. When the status byte 
is X‘'FO' then an entry type 
3 is only 23 bytes long. 


DECLARE statement number 


SETS List Format 


Byte Number 
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1 


2-3 


Description 
Code byte x‘'cs8* 


Overall length of original 
BCD entry 


4-5 


6-542*n1i 


642*n1 


7+24#n1 
onwards 


Entry Type 4 


2*n1 where n1 is the number 
of identifiers in the SETS 
list. If * was specified, 
these bytes contain 2#n1+1. 


Dictionary references of the 
identifiers in the SETS 
list. 


n2, the number of para- 
meters in the SETS list. 


n2 numbers of one byte each. 
These are the parameter 
numbers and will be in 
ascending order. 


Entry type 4 dictionary entries describe 


external entry points. 


follows: 


Byte Number 
1 


2-3 


4-5 


9-11 


12-13 


14 


15 


16-18 


Their format is as 


Description 
Code byte X'‘'Q3' 


Length 


Hash chain, later used 
as the STATIC chain 


Offset of the load constant 
in STATIC 


Offset in the DSA of the 
declaration block of the 
storage for the first 
approximation of the value 
returned. 


The dictionary reference of 
an item in the AUTOMATIC 
chain of the declaring 
block. Entry type 4 entries 
are members of the AUTOMATIC 
chain of the declaring 
block. 


The Entry code byte. (See 
"ENTRY Code Byte” in Section 
3 below). 


The DATA byte. (See “DATA 
Byte” in Section 5 below) 


Data information which is: 

a) with numeric data, the 
precision and scaling, 
left justified 

b) for strings of fixed 
maximum length, the 
binary version of the 
string length in the two 
leftmost bytes of the 


data information 

c) for strings of adjustable 
length, the text refer- 
ence of a second file 
statement giving the 
expression for the string 


length 

19-20 Picture table address if 
required. 

21-22 Dictionary reference of a 
SETS list 

23 Status byte. If this byte is 
X'00" the meaning is the 
same as the status byte in 
an entry type 3. If the 
byte is X*FF* it is implied 
that no parameters were 
described 

24 2#n where n is the number of 
parameters. This is zero if 
the status byte is X‘FF* 

25 n dictionary references to 
parameter descriptions as in 
an entry type 3 

25+2*n Level 

26+24n Count 

27+2*n BCD length-1 

2842*n 

onwards BCD of identifier 

Ent e 5 


Entry type 5 dictionary entries describe 
the entry points which are formal 
parameters. They have the same format as 
entry type 4 except that: 


Byte 1 is x‘'83' 


Bytes 4 and 5 contain the address of 
the formal parameter type 1 entry 


Bytes 6 to 8 contain the offset in the 
DSA of the declaring block of the 
address slot associated with a formal 
parameter 


No BCD is contained in the entry 
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GENERIC Entry Point 


The format for a GENERIC entry point is as 
follows: 


Byte Number Description 

1 Code byte X‘0Q2' 

2-3 Length 

4-5 Hash chain 

6-8 Offset 1 Slot 

9-10 DECLARE statement number 

11 2n, where n is the number 
of two-byte addresses 
following 

12-11+2n Pointers to entry type 4 
or 5, ENTRY labels, or 
BUILTIN entries. These 
entries are made when an 
identifier is given the 
attribute GENERIC. The 
pointers are to the entries 
which contain specifications 
of the various possible 
attributes 

12+2n Level 

13+2n Count 

14+2n BCD length-1 

15+2n BCD 

onwards 


3. CODE BYTES FOR ENTRY DICTIONARY ENTRIES 


ENTRY Code Byte 


This code byte is used in entry type 3, 4, 
and 5 dictionary entries. The format is as 
follows: . 


Bit Number Description 


0 IRREDUCIBLE 
1 REDUCIBLE 

2 USES 

3 SETS 

4 SECONDARY 

5 RECURSIVE 
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Has data attribute 


Not used 


Options Code Byte 


This code is used in entry tyve 1 
Aictionary entries for PROCEDURE 


statements. 


Bit Number 


0 


The format is as follows: 


Description 
REENTRANT 


ON Block 
MAIN 
TASK 
RECURSIVE 


OPTIONS 


Contains RETURN (expression) 


Statement 


ENTRY name is passed as 
argument 


Optimization Byte 


This code byte is used in entry type 1 
dictionary entries. 


Format of the Optimzation Byte: 


Bit Number 


0 
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Description 


Not eligible for DSA in 
library workspace. 


Fligible for DSA in STATIC 
storace. 


Needs invocation count. 
Needs current file slot. 
Contains asynchronous CALL. 
Indicates ORDER cr REORDER 
option 

0 = ORDER, 

1 = REORDER. 
Default is ORDFR 
Not used. 


Not used. 


4. DICTIONARY ENTRIES FOR PATA, LABEL, NL 
STRUCTURE ITEMS 


Label Variables - Obtained from DECLARE 


Statement 


Byte Number 
1 


9-10 


11 


12 


a9 


14 


15 


16 onwards 


Description 


Code byte may he X‘'07', 
KOT  g 2 OKT ST yy X87"; 
X'97", X°AT"', X'B7'. The 
last four cases apnly when 
the item occurred ina 
parameter list ina 
PROCEDURE or ENTRY 
statement. In this case, 
bytes 4 and 5 will contain 
the dictionary reference of 
the corresponding formal 
parameter type 1 entry. In 
the first four cases, bytes 
4 and 5 initially contain 
the hash chain. After the 
scan of the dictionary, this 
slot will be re-used to form 
another chain, e.g., 
AUTOMATIC or STATIC chain 


Length 


Initially contains the hash 
chain. After the dictionary 
scan, this is re-used to 
form another chain, e.qa., 
AUTOMATIC or STATIC chain 


Offset inserted by storage 
allocation phase (as for a 
data item) 


DECLARE statement number 


"Other 1° code byte (See 
"First Code Byte - Other 1" 
in Section 5 below) 


‘Variable' code byte (See 
"Variable Byte" in Section 5 
below) 


"Other 2' code byte (See 
‘Second Code Byte - Other 2" 
in Section 5 below) 


‘Other 3° code hyte (See 
"Third Code Byte - Other 3" 
in Section 5 below) 


‘Other 4' code byte (See 
"Fourth Code Byte - Other 4" 
in Section 5 below) 


Content determined by 
variable code byte. 


After variable information 17-19 


2 bytes . Symbol slot 


1 byte Level 

1 byte Count 

1 byte BCD length-1- 
BCD 


With the exception of the 2-byte symbol 
slot, the general format is the same as for 
a structure. 


Dictionary Entries for Data Items 


The format is as follows: 


Byte Number Description 


1 Code byte may be X‘OF', 
X°LF* X"'2E*, X*SF",; xX SF*, 

X"'9F', X'AF*, or X'BF’. The 
last four cases apply when 
the jtem occurred ina 
‘parameter list ina 
PROCEDURE or ENTRY 
statement. In this case, 
bytes 4 and 5 will contain 
the dictionary reference of 
the corresponding formal .. © = 20-21 
parameter type 1 entry. In 
the first four cases, bytes 
4 and 5 initially contain 
the hash chain. After the 
scan of the dictionary this 
slot will be re-used to form 
another chain, e.g., 
AUTOMATIC or STATIC chain 


2-3 Length 
4-5 See above 
6-8 offset. (See “Format of 


Variable Information" in 
Section 6 below) 


9-10 DECLARE statement number. 
If the variable has not been 
explicitly declared, this 
number is zero; otherwise, 
it is the statement number 
assigned to the DECLARE 22 
statement from which the 
variable was obtained. 


11-16 Six code bytes. These are: 
other 1, variable, other 2, 
other 3, other 4, and data. 


(See “Code bytes" in Section 1 byte 
5 below for a description of 
these bytes.) 1 byte 


Data information, which is: 


1. with numeric data, the 
precision and scaling, 
left justified 

2. for strings of fixed 

Maximum length, the 
binary version of the 
string length in the two 
leftmost bytes of the 
data information 

3. for strings of adjustable 
length, the text 
reference of a second 
file statement giving the 
expression for the string 
length 

4. Bit 0 of byte 19 
indicates that the 
temporary is used as an 
argument for halfword 
binary temporaries 


Note: In the case of a 
temporary data variable for 
an argument, the first bit 
of byte number 19 is set to 
1 by phase GP. It is set to 
0 by phase IM for temporary 
arguments to built-in 
functions and 
pseudo-variables. It is 
examined by phase QU. 


Symbol slot, containing 
either zero, or one of the 
following: 


1. If the SYMBOL and DED 


bits are not on, and the 
data item has a picture, 
these bytes contain the 
dictionary reference of 
the picture table entry 

2. If the DED bit is on and 
the SYMBOL bit off, this 
Slot points at a DED 
entry. If the item has a 
picture, the DED entry 
will contain the picture 
table address 

3. If the SYMBOL bit is on, 
the slot will point at a 
SYMBOL entry. This again 
will contain the picture 
address, if specified 


Variable information. The 
contents of these bytes are 
determined by the variable 
code byte. (See “Format of 
Variable Information" in 
Section 6 below) 


Level 


count 
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1 byte BCD length-1 


BCD 


Major and Minor Structure Entries 


These entries do not include base elements, 
i.e., they do not have any data attributes 
or LABEL. Their format is: 


Byte Number Description 


1 Code byte may be X‘'2E', 
X'3E°, X‘AE', Or X*BE'. The 
last two indicate that there 
is no BCD attached. When 
the identifier occurs in the 
parameter list of a 
PROCEDURE or ENTRY 
statement, bytes 4-5 contain 
the dictionary reference of 
the formal parameter type 1 
entry. In the case of the 
first two code bytes, bytes 
4-5 of the entry initially 
contain the hash chain. 9-10 
This is later modified by 
Phase FT 


2-3 Length 
11-15 
4-5 See byte number 1 


6-8 These bytes are used by the 
storage allocator; they will 16 
finally contain one of the 
following offsets: 


1. For structures which are 
parameters, or are 
dynamically defined, the 
offset from the start of 
the major structures dope 
vector or the minor 
structures dope vector. 

2. For major structures, the 
offset from the start of 


AUTOMATIC or STATIC of 1 byte 
the address slot which 
will point at the 1 byte 
structure dope vector 

3% For CONTROLLED 1 byte 


structures, only that 
specified for minor 
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structures in 1 , above 

4, For structures in 
STATIC EXTERNAL the 
contents depend on the 
setting of the "dope 
vector required" bit in 
the “other 3" code byte. 
If this bit is off and 
the item is a major 
structure, the slot 
contains the offset from 
the start of STATIC of 
the slot which will 
contain the address of 
the first byte of the 
structure. If the dope 
vector bit is on, the 
slot contains the offset 
from the start of STATIC 
of the address slot which 
will point at the 
structure dope vector. 
The offset slot is not 
used in either of the 
above cases for minor 
structures 


DECLARE number, i.e. the 
statement number of the 
DECLARE statement which 
produced the structure 


Five code bytes. These are: 
other 1, variable, other 2, 
other 3, and other 4 


Variable information. The 
content is determined by the 
variable code byte, and will 
always include the 
information required for 
structure members. (The 
format is described under 
"Format of Variable 
Information" in Section 6 
below) 


After variable information: 
Level 

Count 

BCD length-1 


BCD 


5. CODE BYTES FOR DATA, LABEL, AND STRUCTURE DICTIONARY ENTRIES 


The First Code Byte - Other 1 





Sg re le eT a Me ae ee eg ee 
| Bit | ed | | 
|] No. | Description | Set By | 
}-----}---—---~--------------------—-------}-------------—--- { 

0 | Symbol or requires load constant if | Phase EL, FT, or | 
| label constant | NU | 
| | | 
ze | | 

1 | Defined on | Phase EL | 
| | | 
| | | 

2 | Mentioned in CHECK list | Phase FO | 
l i | 
| | os | 

3 | Needs DVD | Various | 
| | | 

4 | Last member in structure | Phases EL or EW | 
{ | | 

5 | Variable dimensions | Phase EL | 
| | | 

6 | * dimensions | Phases EL and FT | 
ir | | 

7 | * string length for data item | Phases EL and FT | 
| | | 
| ~-More labels follow for a label | Phase EG | 
| constant | | 
| | [ 
| ---Major Structure - no member of | Phase EY | 
| the structure has a dimension or | | 
| length attribute which is not * | | 

~The Second Code Byte - Other 2 
Ca et ee ee ee ee aca rane la 1 
| Bit | Description | Set by | 
{| No. | | | 
}-----}--—-----~----—---—--------------~---}------—-----—---} 
{ 0 | Dynamically defined | Phase EL | 
{ | | 
{1 | CONTROLLED ma‘jjor structure with { Phase EY | 
| | varying strings | | 
| | | | 
| 2 | NORMAL = O, ABNORMAL = 1 { Phases EI and FT | 
| | { | 
13 | Reserved | [ 
I { I | 
| 4 | Formal Parameter | Phase EI | 
{ I | | 
| 5 | INTERNAL = 0, EXTERNAL = 1 | Phase EI | 
| [ | [ 
| 6 | 00 = AUTOMATIC or DEFINED or simple | Phase EL | 
| | parameter | | 
| and | I | 
| { | | 
| { 01 = STATIC | Phase EL | 
| | | 
| 7 | 11 = CONTROLLED | Phase EL | 
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The Third Code Byte - Other 3 


meRCRrED? iar arena eS Kel esa Soo ee ee ea re SSS ee 1 
| Bit | | | 
| No. | Description | Set by | 
}-----}----~-------------------------- 4------------—------—---------] 

|| 0 | Needs dope vector | Phases EK and EY if variable | 


dimension entries, variable 
string length, or in 
CONTROLLED storage; 

Phase NU when item appears 
in an argument list 


| 

| | | 

| | | 
| | | | 
| | | | 
| | | | 
| | | | 
{1 | Needs DED | Phase NU | 
| | | | 
fixe | Needs no storage for the item | Phase GP | 
| | itself | | 
| | | | 
| 3 | Correspondence defined | Phase FV | 
| | | | 
| 4 | Chameleon | Phase GP | 
| | | | 
} 5 | Data Variable UNSAFE | Set by phase KE | 
| | | 1= UNSAFE | 
| | | O= SAFE | 
| | | This use is local to the | 
| | | K phases | 
| | { | 
| | Sign bit for first offset | Phase PH for STATIC and | 
| | | Phase PT for AUTOMATIC | 
I | 
! 6 Indication of the state of | Phase PH for STATIC and | 
| | the value in the first offset | Phase PT for AUTOMATIC | 
| | 0 = rubbish | | 
| | 1 = good value | | 
| | | 
7 7 | As above but for second | Phase PH | 
| | address slot | | 
Gs a st es ia Bice a ces Seo eh eh ee ee 
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The Fourth Code Byte - Other 4& 


| SSCS PRR Fa am aaa amma aa a aan aca a ra aaa a aS | 








| Bit | | | 
| No. | Description | Set by 
t--—-- ——--~-------------—------ }------------------- 4 
{| 0 | Usage (i): | Phase EL (for EW) | 
| | An explicit alignment | | 
| { declaration has been made | | 
| | Usage (ii): | Phase JK | 
| | A constant has been produced | | 
| | for this structure or array | | 
l { | | 
{1 | 00 = Not temporary | Phase GP, HF, HK, | 
| and | 01 = Temporary type 2 | IM, or LB | 
| 2 | 10 = Temporary not sold | | 
l {| -11 = COBOL temporary | | 
{ | | | 
| | | | 
| 3 | Member of defined structure | Phase FV | 
| | | | 
| 4 | Packed = 0 Aligned = 1 | Phase EL | 
| | | | 
| 5 | Major structure | Phase EL | 
{ | | | 
| 6 | No dope vector initialization | Phase GP | 
| | | | 
| 7 | A temporary type 2 which has | Phase OB | 
| | been incorporated in work- | | 
| | space 1 or RDV required. For | | 
| | COBOL temporaries this bit | | 
| | means RDV required | | 
| eaencnees eee ee a Ae ee ed 
Variable Byte 
pesos —a-— = 75 

| Bit | Description 
i No. | 

0 Second address slot 

1 Dimensioned 

2 Member of structure 

3 Value list for label variables or 


POS for defined items 


ee GED AD SS ED SD SN NE SY SD ES SD eee a meee cole cee ae 


| 
| 
| 
i 
I 
i 
| 
I 
| 
{ 
| 
{ 
| 
| 
| 
| 
L 


4 Initial value if not a structure 
or LIKE if a structure 
5 EXTERNAL slot 
6 Defined slot 
7 LE adlabaecowatcaa from ALLOCATE statement| | 








For a detailed explanation of the 
significance of these bits and a 
description of the extra slots associated 
with them, see "Format. of Variable 
Information" in this Appendix. 
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Data Byte 


CSS ee ce eect aa ae ee a —-------- oS a 5 saan, eae ba a Saaiee ee ae | 
Lif | [ | | | | | 
! BIT ! 0 1 | 2 | 3 | 4 | 5 | 6 | 7 | 
| | | | | | | 
p—-—--———-}---}--—------—--}---------- + —------- }}-------- }---—-- - $------- f- --------4 
| CAD or | 1 | POINTER/ | Sterling | Long | Cad. | Binary | Float | Complex | 1 
| NUMERIC | | OFFSET * | NON | Short/ | Numeric | Decimal | Fixed | Real | 0 
| FIELD {| { | STERLING | OFFSET | Field | | { | 
[-----—---}—-} -----—-----}---------- 4 ------~-- }-----—--}-------—- }-—---- }+--------- { 
| STRINGS | O | Adjustable | Aligned | Varying | No | Char | AREA | Not ie 
| | | Length | | | Picture | | VARI- | Used | 
| | | String | Unaligned | | Picture | Bit | ABLE®* | | oO 
| ; | | | | I 
ener ee aie eee pave Sele | aeeaee ee Ieee 


*AREA, POINTER, and OFFSET data byte settings are: 
AREA: 
POINTER : 
OFFSET: 


Note: The LONG bit X‘'10' is set to 1 for halfword 


6. FORMAT OF VARIABLE. INFORMATION 


Data items, labels, and structures require 
pointers to various tables if they have 
certain attributes; for example, if they 
are dimensioned or defined on a base. 

Space will be left for information only if 
the attribute is present. This leads to an 
addressing problem of how to find the 
position of the information when the 
presence of other attributes alter its 
address. 


The problem is resolved by collecting, 
into one byte, all the attributes which 
require more than one bit to describe them. 
This has taken the second place in all the 
collections of attribute bytes. The 
presence of a bit in this byte indicates 
the presence of further information. The 
offset of this information from the start 
of the variable information is given by the 
presence of the bits to the left of the one 


X'02" superimposed on the non-pictured CHAR string data byte entry 
X*°40" superimposed on the FIXED BIN data byte entry 
X"°50° superimposed on the FIXED BIN data byte entry 


binary and 0 for fullword binary 


dictionary entry is based on questions 
about the nature of the identifier. 
Refer to Figure 10. 


71 

|Y¥|| implies that a second offset 
t-J slot will be given, 

ra 

{N{ that it will not. 

LJ 


number 1: 


The dimensioned bit. The slot produced 
by this is three bytes long. The first 
byte will contain the number of 
dimensions, the next two the dictionary 
reference of the dimension (multiplier) 
table 


number 2: 


Member of a structure bit. This slot 
is ten bytes long and has the following 
format: 


of interest. Each bit will have a value Byte Number Description 

associated with it. The sum of the values 

of the bits present and to the left of the 1 Declared level number 

one of interest will give the value of the 

offset. This is achieved in the coding by 2 True level number 

moving the code byte, masking off the bits 

to the right of the one being tested and 3-4 Dictionary reference of 

the bit itself, and translating the byte. the containing structure 
The information produced by the presence 5-6 Dictionary reference of 

of the following bits in the variable byte the next member in the 

is as follows : structure 

Bit number 0: 7 Alignment 


The second offset slot is 4 bytes long. 
The contents of this slot are described 
in this appendix. The decision to 
include a second offset slot ina 
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Note: The value held in this 
byte corresponds to ELEMENT 
size (in bits) and would be 
one of the following: 


X*01° - BIT alignment 


X'08" - CHAR alignment 

X°'10" - HALFWORD alignment 

X*20° - FULLWORD alignment 

X*4O* - DOUBLEWORD alignment 
8-10 Element length 


Bit number 3: 


POS for defined items. The two-byte 
slot will contain the POS value as a 
binary integer. 


Bit number 4: 


The initial value or LIKE bit is a 
four-byte slot. 


1. For normal initial value. The first 
two bytes contain the dictionary 
reference of the associated ‘Initial 
Value‘* dictionary entry. The fourth 
byte contains X*FO'* 

2. For INITIAL CALL. The first three 
bytes contain the text reference of 
a second file statement. The fourth 
byte contains X‘OF‘. 

3. For initial labels. The first three 

bytes contain the text reference of 
a set of second file statements. 
The fourth byte contains X'FF'. If 
there is an initial slot but no 
initial values the fourth byte 
contains X*'0OO' 

4. For LIKE. The first two bytes 
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Bit 


Bit 


The DEFINED bit. 


contain the LIKE chain. The third 
and fourth bytes contain the 
dictionary reference of the likened 
structure 


number 53 
The EXTERNAL bit. This 2-byte slot 
contains the ESD number 


number 6: 


This 7-byte slot 
contains the following: 


Byte Number Description 
1-2 Defined chain. 
3-4 Dictionary reference of base 
5-7 The text reference of a 
second file statement. 
After the dictionary these 
bytes will contain X‘FFFFFF' 
if the base is 
unsubscripted. 
Bit number 7: 


The CONTROLLED from ALLOCATE bit. 


This 
bit is on for dictionary entries for 
level 1 CONTROLLED data specified in 
ALLOCATE statements. The two-byte slot 
contains the dictionary reference of 
the dictionary entry for the data 
constructed from the DECLARE statement 
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ee ee ee re ny 


| Entry | 


t__----_,—_----~J 
| 
Vv 
Y| Is it data | 
r--i item? | 
a re J 
| |N 
| Vv 
| a eS ee 1 > 
| | Is it struc- |[N | Is it label IN e-4 
| | ture? ---—----—--->| variable? f--> | N] 
J bp ad -—----7-—- += 4 iJ 
\-----~--—> | <--------------—---------- Y 
YV 
Soe ee 1 ee 
| Is it formal |[Y | Is it struc- |N_ ¢-4 
| parameter? }--------->| ture member? [}--—>|N| 
L_..-..--7—-----—J A eee | LJ 
{N | \¥ 
Vv | V 
Ho Se | rn 
{| Is it con- |¥ | 1Y] 
| }----1 tJ 
| trolled? | 
{N 
Vv 
eS Sees te 1 
|Y | Is it ex- \Y ena 
| Is it static? }-—------->| f--> | Y 
| | | ternal? | tJ 
bd too == i 
Nj <---——-—-—---—---—_-—---------- IN 
Vv 
(SSS 
| : XY p-a 
| Is it string? }-->|Y| 
\N 
Vv 


(PSS a 
| Is it struc- |Y ¢-y 
| ture member? }-->|Y| 


{N 
Vv 
Papamoa 
| [Yea 
{| Is it defined?}-->|Y 
t__-—--_,—--—--4 Lo 
{N 
Vv 
| Papin nea a! ees Soe aeery 
| Is it dimen- |Y ¢-1 
| sioned? t-->1Y | 
Lp ——1 tJ 
|N 
Vv 
1 
[NI 
tJ 


Figure 10. Decision to Include a Second Offset Slot 
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Uses of the OFFSET1 and OFFSET2 Slots in 


Data, Label, and Structure Dictionary 
Entries ; 


The OFFSET1 slot is in bytes 6-8 of the 
dictionary entry and the OFFSET2 slot is 
part of the variable information. 


STATIC INTERNAL Structures 





Major and minor structure entries: 
OFFSET1 slot not used. OFFSET2 slot 


contains offset of structure dope 
vector from start of STATIC INTERNAL 
control section (if there is a dope 
vector) 


Basic elements: OFFSET1 slot contains 
offset of virtual origin (in the case 
of dimensioned items) or offset of item 
(when not dimensioned) from start of 
STATIC INTERNAL control section. 
OFFSET2 slot contains offset of dope 
vector (if there is one) from start of 
STATIC INTERNAL control section 


AUTOMATIC Structures 


Constant dimensions: as for STATIC 
INTERNAL except that all offsets are 
relative to start of DSA. 


Adjustable dimensions: major and minor 
structure entries: OFFSET1 slot not 
used. OFFSET2 slot contains offset of 
structure dope vector from start of DSA 
(if there is a dope vector) 


Rasic elements: OFFSET1 slot not used. 
OFFSET2 slot contains offset of 
element's dope vector (if there is one) 
from the start of the DSA 


STATIC EXTERNAL and Parameter Structures 





Major structure entry: OFFSET1 slot 
contains offset of address slot from 
Start of data region. OFFSET2 slot 
contains size of EXTERNAL control 
section. (Offset of major structure 
dope vector = 0.) 


Minor structure entries: OFFSET1 slot 
not used. OFFSET2 slot contains offset 
of structure's dope vector from start 
of major structure dope vector. 
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Basic elements: OFFSET1 slot not used. 
OFFSET2 slot contains offset of 
element's dope vector from the start of 
the EXTERNAL control section 


CONTROLLED Structures 


Major and minor structures: OFFSET1 slot 
not used. OFFSET2 slot contains offset 
of structure dope vector from point to 
which pseudo register points. (In the 
case of the major structure, this value 
will be zero.) 


Basic elements: OFFSET1 slot not used. 
OFFSET2 slot contains offset of 
element's dope vector relative to 
address in pseudo-register. 


Non-Structured Arrays in STATIC INTERNAL 


OFFSET1 slot contains offset of vertical 
origin of the array relative to start of 
data region. OFFSET2 slot contains offset 
of dope vector (if there is one) from the 
start of the data region. 


Non=Structured Arrays in AUTOMATIC 


Constant dimensions: as for STATIC 


INTERNAL 


Adjustable dimensions: OFFSET1 slot not 
used. OFFSET2 slot contains offset of 
dope vector from start of data region. 


STATIC EXTERNAL, CONTROLLED or Parameter 
Array 


OFFSET1 slot contains offset of address 
slot which contains a pointer to the arrays 
dope vector. (Not used in the case of 
CONTROLLED.) OFFSET2 slot is not present. 


Non-Structured Scalar Strings in STATIC 
INTERNAL 


OFFSET1 slot contains offset of datum from 
start of data region. OFFSET2 slot 
contains offset of dope vector (if there is 
one) from start of data region. 
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Non-Structured Scalar Strings in AUTOMATIC 


Constant length: 


Adjustable length: OFFSET1 slot not 
used. OFFSET2 slot contains offset of 
dope vector from start of data region. 


as for STATIC INTERNAL 


Non-Structured Scalar Strings in STATIC 
EXTERNAL, CONTROLLED or Parameter 


OFFSET1 slot contains offset of address 
slot which points to string dope vector 
(not used in the case of CONTROLLED). 
OFFSET2 slot not present. 


Non-Structured Non-String Scalars in 
AUTOMATIC or STATIC INTERNAL 


OFFSET1 slot contains offset of datum from 
start of data region. OFFSET2 slot not 
present. 


Non-Structured Non-String Scalars in STATIC 
EXTERNAL, CONTROLLED ox Parameter 


OFFSET1 slot contains offset of address 
slot which points to datum (not used in the 
case of CONTROLLED). OFFSET2 slot not 
present. 


7. OTHER DICTIONARY ENTRIES 


Label Constants - Extracted by the Read-In 


Phase 


Byte Number Description 
1 Code byte xX‘00' 
2-3 Length up to BCD length-1 
byte 
4-5 Hash chain - STATIC chain 
6-8 offset 
9-10 Statement number (except 


when the label is mentioned 
in an ON CHECK list, in 
which case it gives the 
chain to the label BCD 
dictionary entry, code byte 
X‘'CE') 
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11 Other 1 Code Byte (See 
“First Code Byte - Other 1" 
in Section 5 above) 


12-14 Second Offset Slot 

15-16 Spare for Final Assembly 
17 Level 

18 Count 

19 Count of Containing Block 
20 BCD Length-1 | 
21 etc. BCD 


Compiler Labels 


The format is identical to that of a label 
constant, except for the omission of the 
BCD. The code byte is X'C3'. If the 
compiler label has been constructed for a 
label variable, then the BCD for the label 


and its subscript will follow on behind the 


entry and the total length of the entry is 
given in bytes 2-3. 


Formal parameter type 1 entry 


These entries are derived from the 
PROCEDURE and ENTRY statements, and do not 
contain any information other than that the 
identifier is a formal parameter. The 
format is as follows: 


Byte Number Description 
1 Code byte x'40' 
2-3 Length 
4-5 Hash chain 


6-7 These bytes will point to a 
full description of the 
identifier after Phase EK, 
or Phase FA, or Phase FE. 
These full descriptions are 
dictionary entries for the 
type of item they are 
describing. They do not 
contain the BCD of the 
identifier, but in the slot 
for the hash chain there is 
the dictionary reference of 
the corresponding formal 
parameter type 1 entry. 


8 Level 


10 
11 


Count 
BCD length-1 
BCD 
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For a description of the types of entry 
pointed to, see “Dictionary entry for 
parameter descriptions." 


Dictionary entry for FILE 


For attributes specified in OPEN statement 
the format is as follows: 


Byte Number Description 
1 Code byte x‘'98' 
2-3 Length 
4-5 STATIC chain 
6-8 OFFSET1 
9-10 DECLARE statement number 


11 onwards String of second level 
markers (without preceding 
*C8* code bytes) one for 
each attribute other than 


FILE, TITLE and IDENT. 
This entry is created by the read-in 


phase and is referred to only as the 
argument of an ATTRIBUTES marker. 


FILE Constants 


Code xX'08' is used for file constant. 
entries, which have the following format: 


Byte Number Description 

1 Code byte x'08' 

2-3 Length 

4-5 Hash chain, subsequently 
EXTERNAL or STATIC chain 
depending on whether FILE is 
EXTERNAL or INTERNAL 

6-8 OFFSET1 (STATIC or transfer 
vector offset) 

9-10 Declare statement number 

11-12 Dictionary reference of 
attributes entry (zero if 
none) 

13 Code byte (similar to the 
“other 2" code byte. Only 
internal/external bit used) 

14-15 Dictionary reference of 


environment string (zero if 
none) 
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16 Level 
17 Count 
18 BCD length-1 


19 onwards BCD 


FILE Parameters and Temporaries 


Code X'89* is used for file parameters and 
for file temporaries. The format of the 
entry will be the same as that for label 
variables. 


FILE Environment Entries 


Code X*c8* is used for the environment 
string. 
Byte Number Description 

1 Code byte xX‘cs8' 

2-3 Length 


4 onwards Internally coded form of 
argument of ENVIRONMENT 


option 


Code x'cC8' is also used for attributes 
collected from the DECLARE statement. 


Byte Number Description 


1 Code byte X'‘'c8* 


2-3 Length 


4 onwards String of second level 
Markers (without preceding 
code bytes X'C8'), one for 
each attribute other than 
FILE, ENVIRONMENT, EXTERNAL, 
or INTERNAL 


Dictionary Entries from Constants 


The format is: 


Byte Number Description 
1 Code byte X'88' 
2-3 Length 
4-5 Hash chain 


6 DATA byte 
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10 
11 
12 


13-14 


15 


Notes: 


1. 
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Data Precision* 


Scale Factor#*# 


*These are the apparent 
precision and factor derived 
from the BCD of the constant 
(see Note 2) 


Type (see note 1) 


DATA byte (2) 


Data Precision (2)** 


Scale Factor (2) ** 


**These bytes are inserted 
by the phase requesting 
conversion, If a picture is 
required, these bytes are 
used to contain a picture 
table reference (see Note 3) | 


Dictionary reference - used 
when a phase requires a 
constant to be converted 
into a specific location in 
storage 


BCD 


The type byte has the following 
meaning: 


First and second bits: 


00 - normal BCD constant. 


The first 
offset slot must be 
relocated by the storage 
allocation phase, to 
contain the offset of the 
converted constant from the 
start of STATIC storage, 
rather than from the start 
of the constants pool 


11 - the BCD is replaced by the 


internal form of the 
constant. The first offset 
slot is treated in the same 
way as for the code 00 


10 or 01 - the constant is required to 


Sixth bit: 


be converted into a 
specific location in 
storage. The second code 
implies the converted 
constant should be made 
negative before being 
stored 


1 indicates that the 


constant requires a DED. 


Seventh bit: 1 indicates that the 
constant requires a dope vector. 


Eighth bit: 1 indicates that no 
conversion is required. 


2. After the constants processor the 
bytes 6 through 8 will contain the 
offset of the constant from the start 


of the pool of constants. 


If a dope 


vector is requested then the offset of 
this from the start of the constants 
pool is eight less than that of the 
converted constant. 


3. Should a DED be required, this will be 


constructed by Phase PL. 


The two 


bytes, precision(2) and scale 
factor(2), will contain a dictionary 
reference of a DED dictionary entry. 
If the constant requires a dope vector 
then Phase OS will make a dictionary 
entry for it, and the dictionary 
reference preceding the BCD will be 
the dictionary reference of this. 


Task Identifiers and EVENT Data 


The format of the dictionary entries for 
task identifiers and EVENT data is, apart 
from the initial code byte, the same as 
that for a label variable. 


Dictionary Entries for Built-in Functions 


The format is: 


Byte Number 
1 


2-3 


4-5 


6-8 


9-10 


11-12 


Description 
Code byte X‘04' 


Length 


Hash chain - later becomes 
the STATIC chain 


Offset - gives the position 
in STATIC storage of the 
load constant for Library 
routine 


Code bytes - the first code 
byte contains a value which 
identifies the built-in 
function and also provides 
information about it. It is 
used mainly by phases IM and 
MD-MM inclusive. The second 
code byte contains further 
information about the 
built-in function (See 
"Second Code Byte. ") 


DECLARE statement number 


13 Level 


14 Count 
15 BCD length-1 
16 BCD 


Second Code Byte 
The second code byte contains the following 
information: 


Bit Number Description 


0 May be passed as an argument 

1 May have an array as an 
argument 

2 Must have an array as an 
argument 

3 Is a pseudo-variable 

) Indicates to which of the 


two tables the offset refers 


5 May have an array (or 
structure) as an argument, 
but will return a scalar 
result 


Internal Library Functions 


Library routines, other than built-in or 
GENERIC functions, are known as Internal 
Library Functions. Their dictionary entry 
format is as follows: 


Byte Number Description 


1 Code Byte xX*Cc2‘ 

2-3 Length 

4-5 Hash chain 

6-8 offset 

9 Library Code - identifies 


the particular Library 
routine required 


10 Not used 
11-12 Code Bytes - the first code 
byte contains a value used 
by phase MG to pick up 
complete information about 
the library function. The 
second code byte contains 


further information about 
the function 


13 Level 


14 Count 


BCD entries 


BCD entries are used when the LIKE or 
DEFINED attributes are used. A short 
dictionary entry with the format given 
below is used. This is pointed at by the 
dictionary entry with the attribute. 


Byte Number Description 
1 Code Byte x'40" 
2-3 Length 
4 BCD length-1 
so) BCD 


Dictionary Entry for Parameter Descriptions 


Dictionary entries for parameter 
descriptions are identical with the normal 
entry for data variable, label variable, 
structure, file, or entry points, except 
for the following details: 


Hash chain contains pointer to formal 
parameter type 1. After Phase FT this 
pointer is moved to the bytes 
containing level and count 

No BCD is present 


No block identification is present for 
ENTRY or FILE 


The code byte for an entry point - 
referred to as entry type 6 - is xX'86‘ 


ON Statements 


Entries for ON statements are made by Phase 
FO, and contain the following: 


Byte Number Description 
1 Code Byte X'CD* 
2-3 Length 
4~5 AUTOMATIC chain 
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10 


11 
12 


13 onwards 


ON Condition 


offset 


Code byte as supplied by the 
Read-In Phase 


Block level 


Block count 
n 
n dictionary references of 


variables or ON condition 
entries 


This entry is made by Phase FO: 


Byte Number 


10 
11 
12 


Description 
Code Byte X‘'4D* 


Length 


Hash chain later used as 
AUTOMATIC chain 


Offset 


Code byte as supplied by the 
read in phase 


Block level 
Block count 


BCD lenyth-1 


13 onwards BCD 


CHECK List Entry 


This entry is made by Phase FO: 


Byte Number 


408 


5 onwards 


Description 

Code Byte xX‘C8° 

Length | 

n where n is the number of 
dictionary references 


following 


Dictionary references (2n 
bytes) © 


PICTURE Entry 


The format of an entry in the picture table 
in the dictionary. 


Byte Number 
1 


2-3 
4-5 


6-8 


10 


11 


12 


‘picture following. 


Description 
Code Byte X‘C8° 


Length = L+13 


Contains address of next 
entry in picture chain 


Usage (1) (Before Phase FQ) 
Dictionary reference of 
associated declare or format 
statement, right adjusted 


Usage (11) 
Offset in STATIC storage 


Code Byte (after Phase FQ) 
(See Code Byte description) 


P - the number of digit 
positions in field in 
numeric picture. 


Q - the number of digit 
positions after V character 


in numeric picture. Code 
X‘'80* represents 0, X‘'7F‘ 
represents -1, and X‘'81' 


represents +1. 


W - apparent length of 
picture. - length of 

(For a 
non-numeric picture the 
length is obtained in bytes 
12-13.) 


14 onwards Picture. 


Byte 9 - Code Byte 


Bit Number 


0 


Description 


string 
numeric 


FO 


correct 
error 


oO 


not sterlind 
sterling 


short 
long 


© ke © 


Not used 


5 0 decimal 
1 binary 


6 0 fixed 
1 floating 


7 Not used 


Dictionary Entry for Workspace Requirement 


The format for a dictionary entry for 
workspace requirement is: 


Byte Number Description 
1 Code Byte X'C8* or X‘'CA‘ 
2-3 Length = 8 . 
4-5 Total workspace required 
6-8 Offset 


If the code byte is C8 this is the 
temporary workspace used by pseudo-code 
(temporary type 1). 


Dictionary Entry for Parameter Lists 


Dictionary entries for parameter lists have 
the following format: 


Byte Number Description 
1 Code Byte x'c5' 
2-3 Length 
4-5 STATIC chain 
6-8 STATIC offset 
9-10 Assembled length 


11 onwards Contains DCA's 


Dictionary Entries for Dope Vector 
Skeletons 


Byte Number Description 
1 . Code Byte X'C6' 
2-3 Length 
4-5 STATIC chain 
6-8 Offset in STATIC 


9-10 Dictionary reference or 


DECLARE number 


11 onwards Bit pattern of skeleton dope 
vector 


This entry is constructed by Phase PD 


Symbol Table Entry 


Symbol table entries are made by Phase PL. 


Byte Number Description 

1 Code Byte X‘C7' 

2-3 Length 

4-5 STATIC chain 

6-8 Offset in STATIC of DED 

9-11 Actual DED if not pictured. 
If a picture is involved, 
the last two bytes are the 
dictionary reference of the 
picture table entry 

12-13 Offset in STATIC storage of 
symbol table entry 

14-15 Dictionary reference of next 
item in the symbol table for 
this block 

16-17 Dictionary reference of item 


requiring entry in symbol 
table 


Dictionary Entry for AUTOMATIC Chain 
Delimiter 


An entry for AUTOMATIC chain delimiter is 
made by Phase PP. 


Byte Number Description 


1 Code Byte xX‘'cc* 

2-3 Length 

4-5 AUTOMATIC chain 

6-7 Pointer to first second file 
entry 

8-9 Pointer to second second 
file entry 
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DED Dictionary Entry 


An entry for a DED is created by Phase PL. 


Byte Number Description 
1 Code Byte X‘C7' 
2-3 Length 
4-5 STATIC or AUTOMATIC chain 
6-8 Offset 
9-10 Dictionary reference of 
variable 
11-18 Eight bytes of RDV text 
19-20 DECLARE number 


The LONG bit X'10° of byte 9 is set to 1 
for halfword binary and 0 for fullword 
binary. 


If the DED requires a picture, the last 
two bytes contain the dictionary reference 
of the picture table entry. 


This entry has the same format as the 
first eleven bytes of a symbol table entry. 
No item will require both types of entry. 
The type required will be chained from the 
symbol slot in an item. 


DED2 Entries 


These entries are generated when a DED is 
required for the conversion of a temporary 
result. 


Byte Number Description 
1 Code Byte xX‘cl1' 
2-3 Length = 11 
4-5 STATIC chain 
6-8 Offset 
9-11 Actual DED 


Dictionary Entry for FED - Format Element 
Descriptor 


The entry for a FED is made by Phase NV. 
The entry is identical with a DED2 entry 


but with a length of 12, instead of 11. 
The storage allocated will be word-aligned. 
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Byte Number Description 


1 Code Byte xX'Cl1' 
2-3 Length = 12 

4-5 STATIC chain 
6-8 STATIC offset 
9-12 Actual FED 


Label BCD Entries 


Label BCD entries are made by Phase FO. 


Byte Number Description 


1 Code Byte X'CE' 
2-3 Length 
4-5 DECLARE number 
6-7 Offset of the BCD 
in STATIC 
8-9 Dictionary reference of item 


requiring BCD 


These entries are constructed when a 
statement label or a PROCEDURE or ENTRY 
label is mentioned in an ON CHECK list. 
These entries are also made for EVENT and 
TASK variables. Phase PD will allocate 
storage in STATIC for the BCD of the label, 
and place the offset of this in the above 
entry. 


Dope Vector Entries for Temporaries 


This entry is constructed to indicate that 
a dope vector is required for a temporary 
result. At this stage the bytes in the 
entry contain the following: 


Byte Number Description 

1 Code Byte x‘C0‘ 

2-3 Length 

4-5 AUTOMATIC chain 

6-8 - Offset in the temporary type 
1 stack. After Phase QJ 
this will contain the offset 
from the start of the DSA 

9-10 Dictionary reference of dope 


vector skeleton entry 


11-12 


Length of string 


Record Dope Vector Entry 


This entry is constructed when a variable 
requires a record dope vector. 


Byte Number 
1 


2-3 
4-5 
6-8 


9-10 


11-18 


19-20 


Description 
Code Byte x'c29' 


Length 
STATIC or AUTOMATIC chain 
Offset 


Dictionary reference of 
variable 


Eight bytes of RDV text 


DECLARE number 


Dope Vector Descriptor Entry 


This entry is constructed for a structure 
which requires a dope vector descriptor. 


Byte Number 
1 


2-3 
4-5 
6-8 
9-10 


11-12 


13... 


Description 
Code Byte x'cc’ 


Length 
STATIC chain 
offset 


Dictionary reference of 
structure 


Chain to RDV entry or 
DECLARE number 


DVD text set up by Phase JK 


Format of a Second File Dictionary Entry 


Byte Number 
1 


2-3 


4-5 


Description 
Code byte X‘'cs8* 
Length of entry 


Statement number of the 
DECLARE or other statement 
giving rise to the second 
file statement 
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Dictionary reference of the 
entry type 1 of the block 
from which the second file 
Statement was extracted 


Dictionary reference of a 
three-byte slot in the 
dictionary. 


Type of second file 
statement, i.e. the 
function it performs. This 
is the second byte of the 
dictionary reference used to 
designate the function in 
the actual second file 
statement 


Dictionary Entry for a STATIC DSA 


This entry is made by phase PA (whenever a 
block has its DSA in STATIC). The “size of 
DSA" slot (right-hand two bytes) in the 
Entry Type 1 is used to contain the 
dictionary reference in this entry. 


Byte Number 


1 
2-3 
4-5 


14-16, 
17-18 


19-20 


Description 


Code byte x‘'cs’ - 
Length = 20 

Dictionary reference of the 
next STATIC DSA entry, or 
zero if this is the last 
entry. 

Offset address slot in. 
STATIC for the DSA (set by 
phase PD). 

Size of DSA (set by PT and 
amended by RF). 

Dictionary reference of the 
Entry Type 1 of the block. 
Code byte to be put into 
first byte of DSA. 

Offset of start of DSA in 
STATIC (set by phase TO). 
Head of block's automatic 
chain. 

Not used 


Dictionary Entry for an Error Message 


Byte Number 


Description 


Code byte X'‘'c8' 

Length 

Chain 

Messages number 

Flags: 

Bit 0 on if text to be 

inserted in message 
1 on if statement number 
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to be inserted Byte Number Description 
2 on if a numeric parameter 


to be inserted 1 Code byte x‘c8° 
3 on if a dictionary 2-3 Length 
reference to be inserted 4 Flag: X‘'00' Text that 
4-7 Severity: X‘'O" Termin- follows has not been 
ation truncated and is 10 bytes 
X'4" Severe or less 
X‘'8* Error X01" Text that follows is 
X*C' Warning not to be truncated and is 
9 Variable information in the greater than 10 bytes 
format shown below: X*FF* Text that follows has 
been truncated and is to 
be printed within quotes. 
2 bytes Statement number 5. Variable length of text (in 
(if present) compiler internal code). 


2 bytes Numeric parameter 
(if present) 
2 bytes Dictionary 
reference (if present) 
8. DIMENSION TABLE 
If text is to be inserted it is 
contained in a second dictionary entry 


immediately following the main entry for Each entry containing dimension information 
the message. The format of this second will result in a table being set up. This 
entry is: table is shown in Figure 11. 
| Code Byte c8 =| Two-byte length |. Flag Byte | 
}--------~------ a 4----~-~-----—-—---------- Sc a snc Se ni Sa sm wesc cn ss ep ein secs Smo Se i Sees ents ei a Sin ns 
| Zero byte |No. of dimensions (n) | Two-byte chain address | 
J--------------- 1 ~--- ------ === +L --—-~ == === == === === -| 
| VIRTUAL ORIGIN WORD | 
frame nnn nn nn nn a nn nnn nn nnn nnn nnn { 
| One-byte marker | Not used | Lower bound (halfword) | | 
ee es 
| One-byte marker | Not used ' | Upper bound (halfword) | 
Ne a 
fa i a neem re + 
| | | nth upper bound | 
}------------—------ oar CNS re Fa Pen Bee ee hl 4 


n multipliers | | 


be eee eee ee, ea eee en eae ead 
Note: The one-byte marker is: 
00 if bound is fixed point constant; bound is a two-byte binary constant, right-adjusted. 


FF if bound is an expression; bound is a three-byte pointer to a second file statement in 
text. 


7F if the bound is inherited and has an MTF function. 
3F if the bound is inherited and is covered by a previous MTF function. 
FO if the bound is specified by an *. 


Figure 11. Dimension Table 


9. DICTIONARY ENTRIES FOR INITIAL VALUES An INITIAL dictionary entry 
and 
The declaration of a variable with an ee 
INITIAL attribute produces these entries: One .or more dictionary entries for 
constants 
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and perhaps 


A second File Statement for any iteration 
expression contained in the INITIAL 
specification. 


The INITIAL dictionary entry contains 
pointers to the constant entries and any 
Second File Statements, and is of the 
following format. 


Description 


Code Byte xX 'c8* 
3 Length of entry 
Prefix options byte 
INITIAL code byte X '79' 
Left parenthesis 
INITIAL value list (see 
below) 
Right parenthesis 


Byte Number 


Ane I pe 


7 onwards 


Final 


INITIAL Value List 


The INITIAL value list contains references 
to Second File Statements and dictionary 
entries which are created to correspond to 
the value in the input text. 


The list contains the following code 
bytes to identify each associated 
dictionary reference: 


X'F1" Constant iteration factor. This is 
followed by X*'00° and the dictionary 
reference of the constant iteration 


factor. 


X'F3" INITIAL value item. This is 
followed by X'00° and the dictionary 
reference of the constant. (The BCD 
of the constant is expanded by any 


imposed string replication factor). 


X'FS* EOB marker. This is followed by 
X'00° and the dictionary reference 
of the next entry on the chain. 
(This will occur when the scratch 
core storage allocated for building 
the entry is not sufficient, and a 
chain of entries is constructed). 
X'F7" Variable iteration factor. This is 
followed by the text reference of 
the Second File Statement containing 
the expression. 
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APPENDIX D: INTERNAL FORMATS OF TEXT 


This appendix describes the internal 
formats of text at various points during 
the compilation of a source program. The 
appendix is organized in the following 


Manner: 

1. Text Code Bytes after the Read-In 
Phase 

2. Text Formats after the Read-In Phase 

3. Text Code Bytes on Entry to the 
Translator Phases 

4. Format of Triples 

5. Text Code Bytes in Pseudo-Code 

6. Text Formats in Pseudo-Code 
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7. ‘Text Formats in Absolute Code 


8. Second File Statements, and the 
Formats of Compiler Functions and 
Pseudo-Variables 


9. Pseudo-Code Phase Temporary Result 
Descriptors (TMPDs) 


10. Library Calling Sequences 


11. Descriptions of Terms and 
Abbreviations used in Text During a 
Compilation 


Note: The internal formats of text during 
compile-time processing are described 
in Appendix J. 


1. 


TEXT CODE BYTE AFTER THE READ-IN PHASE 


First Level Table (00 to 7F) 





\ 1 ' { | i 1 1 | j \ \ i \ 1 { 
t \ ' | \ i 1 { | | reid i+] 1 | 
' 1 1 i | \ \ 1 i \ | { ' | \ \ 
! | | t= | i ! i: | | I> xt | | 
I ! I i>] i 1 | le- tHot ixl tel 
he | | ol+¢ \ fe i * | > [he | 1 he | \* \ 
mot db Pod do TBE PE dere ede tI 
fo Yo f fo | Pe de eee { | 
| | | \ ' | { i ' | I | | i | 
at | t tat f ff 
i Sew oe ope: ob a ivi 
1oaint \ rn i | | ! | \ | | \ i 
1amlit ! iV | \ i | | | | | r 
i { | \ i 1 | | i i | | 
Sa a a aoe a cea as eal a a A 
| f | f f ~ fa | ET f | | g | | 
| ' i | | i Iw | | | | \ \ | { I 
maeete: Cerne re 
tw | { i | i 1H} | | | ' \ | on | 
| i ' i | ! lao | | | | \ | 1am | { 
\ 1 { 1 | i ipwn | | i | | | 1HO | | 
i | | | ' \ Lac | \ i | | i a oe i 
—+—-1-4-4~-4-4-4-—1_-4_4__4_4_4_4—-1_4 
(ercercee 2. ee. ew 
\ | | | i 1 le 4 t—! \ { i | i 
aetit-e tein] Ina} 6 $ RD Loutmiw Jum im) | r 
i. ! | i | | | | | | 
fo | | j | | | | | | | | | 
' | | i \ i i | i i | 
ee de Ue we Act ae Se a 
Pane eemene 2 fare 
e| jelelete lela jeiwleer Bil ob | 
Eee eee ee Abe al 
Po oft dt tt ot 4 tal teh ob odd 
| | | | j | | i | ia> | | | | | \ 
He Se See fae ese Semes CORIS tee ees WDE Urs Lg Does meen Uae 
1 i | | j T | i i T | T + | ze 7 
#1 | ae = 12 1o | a | OF ! ! | q 
@ |< {eo | O 1A tm I fe |e bast ook i \ { { | | 
| | | | | | | i | | | | | | i 
| f | | | { f[ | | | = 
1 ' i j | \ 1 | i 1 \ i ' im 4 { 
ae ais cen oh a bee we eS Vee beet 1 4 } 1% ! 
| \ j | | | | i | i 1a | | 
\ I | 1 | | i | | | | | | ip | | 
i ee ee eee ee 
aww ade ou ew ome whee qeue othe eee alee coe mip ewes che eee ae whe ee Fae are a See: Ses Pe ce ee 
So e N ae] k— wn wo é~ foe) a «c [ue] YO a fx} fee 


|<—Digits—>|<---—--Letters-—-————> | <------~—-—--~--—-—-—Operators—-—--—--—-—---—-—-—> | 
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! 
| 
/ 
| 
| 
| 
| 
}---~-~~-}-~-----}---------- | ------f---------}----------t-ff 
| 
| 
| 
| 


a 
| 


|FL DEC IMAG 
~-}------------- 
|FL DEC REAL 
|FL BIN IMAG 
|FL BIN REAL 
[FIX DEC IMAG 
|FIX DEC RFAL | 
|FIX BIN IMAG | 
|FIX BIN REAL | 
{STG DEC REAL | 
a Sena a Ca a a, (cmd ea a ne ae Ca ee | 
| CROSS SECTION 


| ARRAY 


| isuB 


}---—----}-----~-}---------- f ------f --------- =~ === == ff nnn 


| 
| 
| 
|END ITDO | INTEGER 
| 
| 


|END BLOCK|CHAR CONSTANT} 


JON PROC 
{END DO 
[END PROG |ON 


| END 


p+-------}------- 4 -----—--- f-------}--------- 4 ------- +--+ 


| REWRITE 


| UNLOCK 


| OPEN 


| 
| 
| 

}--------}------} ----—-- |. ------ }---------}----------}---------f ------- === == 
| 


JASSIGN BY | 
ban nf nnn nnn nnn fanned 


| 

| SN 

| NAME 
|SL 
|SL' 
ICN 
|GET 
[cL 

| PUT 
| 


WRITE 





}2nd LEVEL] 
READ 


| MARKER 
| DELETE 


| LOCATE 





|LIST po| 


| 

| 

| 
acc NOD rae eee Set SR SN na 
Saceaater -eweeret ST SEEET TooTTEE REREEEEEE PoE EET oa 
=a Ta a a a ma a 
aad ee ae oe eee ec 
Nee ee | 


}--------}--~-----}-------~-- f------- }-------------------f---------f---------- ~~] 


ENTRY 
BEGIN 
JNO SNAP| 


{HYBRID | 








{QUAL 
| PROC 

| CHECK 
| ITDO 
| NO 

| CHECK 
{DATA 
| SN2 

| ELSE 


| DO 


f-----=--4------- f-- == --—--- F=f fp 


JINIT LABEL IF 


| DECLARE 





GO_TO 


| RETURN 





| 

JA 

| 

| CALL 
1B 

|P 
GOOB 
|R 

| 

| 

| 

| 

| 

| 

|x 


| DISPLAY | 
|SIGNAL | 
[REVERT | 


| NULL 


ee ee ee 


| 

| LINE 
| 

| 

{ 
[COL 
| 

JE 

I 

IF 

( 

jc 


1 |ALLOCATE| 


DELAY 





EXIT 





p--------}------- f= === fa fn fn nnn fn nnn fn nnn ad 


Ce eS ae PN rag aC dee Oe, ya pc Pes PM pe coe Crt me ee ee eas et oe aaa ata gear ae eg a oa ee ee aero eee eae 


JCONTROL | 
C |VARIABLE| 


| 
| 
| 
A | THEN 
| 


8 |SYSTEM 


| 
0 |TO 


First Level Table (80 to FF) 


2 |BY 
3 | FREE 
4 [WHILE 
15 | 
6 {SNAP 
7 
9 {WAIT 
B | 
D | 
| F 


|BIT CONSTANT | 





CLOSE 


|FORMAT | 


ASSIGN 








STOP 
l_.. ... --L--—- — -—- L-—— — -—~--—- LL ~~. - +1 Lb 


F | 
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Second Level Table (00 to 7F) (preceded by second level marker byte C8) 


0 1 2 3 4 5 6 7 
Grn Sn cy ty ToS a ee at) Saar raaee We ee en ee re ape Ee oe ete ee PNT tae ee one crag 
0 | | PILE | | | DECIMAL {OPTIONS {EXTERNAL {AREA | 
}---------- }-~----—}-----} ---- }-------------f ----------}------=--- $= === 
1 | | | | | BINARY {J IRREDUCIBLE|INTERNAL |POINTER | 
}--------—}------—-}-------}------- }-----------—--f---—-------}----------4---------4 
2 | [LIST { { | FLOAT |REDUCIBLE |AUTOMATIC |EVENT | 
p-—~-----}------—}---—-—--------f---------------------—- }----------}--------- { 
3 | JEDIT |EVENT2 | | FIXED |RECURSIVE |STATIC | TASK | 
~---------}------—}--—---- }}------- } -—---------f--------—- $---~------}--------- 1 
4 | TITLE |DATA | PRIORITY | | REAL | ABNORMAL? |CONTROLLED|CELL | 
AF LS A TS SES OE TS SSS FS LY SS A SS ce —~---~—4}------- - + --—- - $----- - -- + — a a ee oe ae eS ee ee -——_— ee ee eee 
5 JATTRIBUTES|STRING |REPLY | { COMPLEX | NORMAL 2 | SECONDARY | BASED | 
~~-----—--}------—}--------}-------}-------------- === ----- }-----=----}------- = 
6 |PAGESIZE {SKIP | | [PRECISION 1 |USES2 | |OFFSET | 
}-------—- $---~--—-}---~----}------- }-----------—- $----------- }--------- ~}--------- { 
7 | IDENT {LINE | | {PRECISION 2. |SETS? | | | 
~-~-~-----}--~---—}--—--- }-------}. ------------f === ---- f= === == f+ 
8 |LINESIZE |PAGE | | | VARYING | ENTRY JINITVAR 1 | | 
}-------—-}-------—-4-----—-- $---~~--}------—-----—-}-----------}----------4------- 
9 | {COPY | | |PICTURE(NUM) {GENERIC JINITIAL |INITVAR 2| 
-------—- ~----—-}-----~--4-------}-----------—-} ----------- }}----------$----- = 
A [INTO |KEYTO ] | {BIT ATTRIBUTE |BUILTIN | LIKE | | 
~—-—-~-~--}--------}}-------- }- ------ ~~ ------ ff $------~ — 
B | FROM |TASKOP | | |CHAR ATTRIBUTE | {DEFINED | { 
—------- $--------}---—---}-------f ----- ~~ -- f= - f= === 
Cc [SET { {IN | DIMS (INTEGERS) | {ALIGNED | r 
p-------—--}- ------—}---—---- 4 ------- f-----------~--}-----------}---- =~ == 
D | KEY | | | | LABEL | ORDER {UNALIGNED | | 
~~—------}------—}---——--- }---—-- }-----------f------ ~~ -—--- == ff 
E |NOLOCK |KEYFROM | { | | REORDER |PACKED2 | | 
|——-----—-------—}-—-—_--- $------- ~----~----~--}-----------}----------$--------- 
[FORMAT | | | DIMS I { {PICTURE | 
F | IGNORE {LIST | |BY NAME] (NON-INTEGER) |RETURNS | POS [(CHAR) | 
t.—_--.-—— ow 1. -— —1 .... ~~ LL be Ld 


4The EVENT built-in function and pseudo-variable are known SxEerueety by the 
equivalent name COMPLETION. 


2O0bsolete attribute. The second level marker is used only to ensure correct 
warning message transmission in Read-In, and does not appear in text at any time. 
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Second Level Table (80 to FF) 


8 9 A a: 





Cc D E F 
i a ea es ane ae! en Seeser res -y--------- ee i a is a a a 
0 |BUFFERED | | ae | | OVERFLOW |CONVERSION|CONDITION| 
1 | UNBUFFERED | | | | H H ‘- 
}-------—-- $-~--------+--------- $------—-- +------ }+---------- $---------- $--------- { 
| | | | | | |STRING- | | 
2 JEXCLUSIVE | | | REENTRANT | | UNDERFLOW | RANGE | NAME | 
}-------——-- }---------- --------- }--------- $------}---------- }$---------- $--------- { 
3 | KEYED | | I | | | | | 
}-------—--}---------- }--~-~----}--------- $------}----------}---------- ---~--~- 
4 |STREAM | | | SECONDARY | | ZERODIVIDE|AREA {TRANSMIT | 
}-----------}-----—---}--—-----f --------- f------4--------- ---------}--------- { 
5 |RECORD | | | | | |PENDING | { 
}-------—--4----------}------—--}--------- ------}---------- $---------- t--------- 
| | | FIXED | | | 
6 |BACKWARDS | | | TASK | | OVERFLOW |ENDFILE  |CHECK | 
-------—-- ~--~-----}-—-------}--------- f------} += === f= ff 
7 (SEQUENTIAL | | | | | | | | 
p-------—---}----~—----f----------------f ------f--------- $---------- }---------4 
| | | | [SUBSCRIPT | | | 
8 |DIRECT { | |ON-BLOCK | | RANGE JON RECORD | ] 
}---~-------}----------}---------}------—------- +~----—---- $---------- $--------- : 
9 | PRINT { | I | | | | | 
----------- ~-~------}-~-------}---------f-—---} ---------- f-—-----------------4 
A |ENVIRONMENT | | | | | ERROR |END PAGE | | 
}-------—--}-----——---} —---—--}---—----- f- —----}----—--- }---------- }--------- 
B |INPUT | | { | | | | | 
~--~---——--}----------}} —-- == f= ff nnn fn nn 
Cc {OUTPUT | i | | | FINISH | KEY |NOCHECK | 
}-----------}----------4------—--}--------- }----- + ---------- $~—-------- $--------- { 
D | UPDATE | | | | | | | | 
}-----------}----------}---------}--------- }------ ---------- - —- ------ === 
| | | | | | [UNDEFINED | | 
E |TRANSIENT | | | | | SIZE | FILE | | 
}—------—-- 4---------~ $—------- 4------—-- +----- +---------- fen-~-----~ }--------- : 
F | | | | | | | | | 
Ase eae eet oe a ie SENSES eee en oe aa eae ee oan pean ee ee J 
2. TEXT FORMATS AFTER THE READ-IN PHASE ------—— mI a Ca SC aa SE STH 7 
| Bir | ON CONDITION | 
}----—---- }------—--------------------- —-4 
In the following statement formats the code | 0 | OVERFLOW | 
bytes SN, SL, SL', POS, and OB have the H 1 | UNDERFLOW | 
following meanings: | 2 | ZERODIVIDE | 
| 3 | FIXEDOVERFLOW | 
| 4 | SUBSCRIPTRANGE | 
SN statement number | 5 | SIZE | 
| 6 | CONVERSION | 
| 7 | STRINGRANGE | 
SL statement label t_-_----_-~ Le J 


SL‘ initial label 


POS following SN is a 2-byte statement 
number 
following SL is a 2-byte 
dictionary reference of statement 
label or entry type 1 


The abbreviation SQUID means an 
identifier, possibly subscripted and/or 
qualified. 


PROCEDURE Statement 


OB prefix options byte, specifying ON 
conditions enabled for the 
statement as follows: 
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The format of a PROCEDURE statement is as 
follows: 


Byte Number Description 


1 Code byte SN or SL. 

2-3 POS 

4 OB 

5 PROCEDURE 

6 Block level 

7 Block count 

8-10 PROCEDURE-BEGIN chain 
11-13 DECLARE chain 

14-16 ENTRY chain 

17 Left parenthesis - optional 
18... Format parameter list - 


optional 

Right parenthesis - optional 
Attribute marker - optional 
Attribute code - optional 
Attribute list - optional 


Statement terminating 
semicolon 


ENTRY Statement 


The format of an ENTRY statement is as 
follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
rT} OB 
5 ENTRY 
6-8 ENTRY chain 
9 Block level 
10 Block count 
11 . Left parenthesis - optional 
12...6 Formal parameter list - | 


optional 
Right parenthesis - optional 


Attribute marker - optional 


Attribute code - optional 
Attribute List - optional 


Statement terminating 
semicolon 


BEGIN Statement 


The format of a BEGIN statement is as 
follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 BEGIN 
6 Block level 
7 Block count 
8-10 PROCEDURE-BEGIN chain 
11-13 DECLARE chain 
14 Statement terminating 


semicolon 


END Statement 


The format of an END statement is as 
follows: 


Byte Number Description 

1 Code byte SN or SL 

2-3 POS 

4 OB 
ends a PROCEDURE or BEGIN 
block; END2 ends an 
iterative DO block; END3 
ends a non-iterative DO 
block 

6 Block level for the 
containing block 

7 Block count for the 
containing block 

8 Statement terminating 


semicolon 
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IF Statement 


The format of an IF statement is as 
follows: 


Description 


Fyte Number 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 IF 
Bese Expression 
THEN 


Statement or Group 
ELSE - optional 


Statement or Group 
optional 


Note: The semicolon preceding the ELSE has 
been deleted 


DO Statement 


The format of a DO statement is as follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 DO or ITDO 
6 CV 
7 BKC 
Biaiee Squid 

DO equals 
Expression 
TO 
Expression 
BY 
Expression 
WHILE 
Expression 
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Statement terminating 
semicolon 


ON Statement 


The ON statement takes one of the following 
formats: 


Beek Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 ON 
6 ON Condition 
7 SNAP or NOSNAP 
8 Statement or block 
2. 
Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 ON 
6 ON Condition 
7 System 
8 SNAP or NOSNAP 


ASSIGN Statement 


The format of the ASSIGN statement is as 
follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 ASSIGN or ASSIGN BY NAME 
Bees Squid 


Comma - optional, 
may be repeated 


Squid - optional, 
may be repeated 


Variable number of bytes - 
optional, may be repeated 


ASSIGN 
Expression 


Statement terminating 
semicolon 


WAIT Statement 


The WAIT statement has the following 
format: 


Byte Number Description 
1 Code Byte SN or SL 
2-3 POS 
4 OB 
5 WAIT 
6 Left parenthesis 
Dean Identifier 


Left parenthesis - optional 
Expression - optional 

Right parenthesis - optional 
Comma 


Further optional parentheses 
and expressions 


Right parenthesis 

Left parenthesis - optional 
Expression - optional 

Right parenthesis - optional 


Statement terminating 
semicolon 


CALL Statement 


The CALL statement has the following 
format: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 CALL 
6-8 CALL chain 
9 Identifier 
10 Left parenthesis 
11 Expression 
12... Right parenthesis 


Left parenthesis 
Argument List 
Right parenthesis 


Statement terminating 
semicolon 


GO TO Statement 


The format of the GO TO statement is as 
follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 GO TO 
Geeoe Squid 


Statement terminating 
semicolon 
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SIGNAL and REVERT Statements 





The SIGNAL and REVERT statements have the 
following format: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 SIGNAL or REVERT 
6 ON Condition 
7 Statement terminating 


semicolon 


DISPLAY Statement 


The format of the DISPLAY statement is as 
follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
q OB 
5 DISPLAY 
6 Left parenthesis 
Tee Expression 


Right parenthesis 
Left parenthesis - optional 


Squid - optional 


Right parenthesis - optional | 


Statement terminating 
semicolon 


DELAY Statement 


The format of the DELAY statement is as 
follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
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4 OB 

5 DELAY 

6 Left parenthesis 
Teas Expression 


Right parenthesis 


Statement terminating 
semicolon 


RETURN Statement 


The format of the RETURN statement is as 
follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 RETURN 
6 Left parenthesis - optional 
dames Expression - optional 


Right parenthesis - optional 


Statement terminating 
semicolon 


STOP, EXIT, and Null Statements 


The format of STOP, EXIT and Null 
statements is as follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 Statement identifier 
6 Statement terminating 


semicolon 


INITIAL Label DECLARE Statements 


The format of INITIAL label DECLARE 
statements is as follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
u OB 
5 INITIAL Label DECLARE 
6-8 DECLARE chain 
OC ese INITIAL label 


Statement terminating 
semicolon 


DECLARE and ALLOCATE Statements 


The format of DECLARE and ALLOCATE 
statements is as follows: 


Byte Number Description 


1 Code byte SN or SL 

2-3 POS 

4 OB 

5 DECLARE or ALLOCATE 

6-8 DECLARE chain or ALLOCATE 
chain 

9.06 Declaration list 


Statement terminating 
semicolon 


FORMAT Statements 





The format of the FORMAT statement is as 
follows: 


Byte Number Description 
1 Code byte SN or SL 


2-3 POS 

i} OB 

5 FORMAT 

6.20 Format list 


Statement terminating 
semicolon 


Format items are replaced by one-byte 
codes 


OPEN and CLOSE Statements 


The format of OPEN and CLOSE statements 
follows. 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
5 OPEN or CLOSE 
6... File group list 


Statement terminating 
semicolon 


READ, WRITE, GET, PUT, REWRITE, UNLOCK, and 
DELETE Statements 


The format of READ, WRITE, GET, PUT, 
REWRITE, UNLOCK, and DELETE statements is 
as follows: 


Byte Number Description 
1 Code byte SN or SL 
2-3 POS 
4 OB 
3) Statement identifier 
6.06 Option list 


Statement terminating 
semicolon 
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36 


TEXT CODE BYTES ON ENTRY TO THE 
TRANSLATOR PHASES 


0 1 2 3 4 S) 6 7 


er We ee MS gt ee ee ENGNG yew EN eRe ey ee Bee nd ee ey te Pee ee Pn eg ee ee ey 


| | | |COMPILER | l | | COMPILER | 
|DICT. REF. |FILE | | FUNCTION | |FILE' | | FUNCTION' 
bona fn nn fn nf nnn nnn fn nn fen fo nnn ff 
{ | | | |COMMA | { {DO EQUALS | } | 
| -------—-- |------ — 4 ------ -- -- $f -- nn fn fn nn nn nnn f+ ------f 
| | |COMPILER | | | | COMPILER 
| |LIST | | FUNCTION |FCOMMA |LIST' | | FUNCTION CALL’ | 
| | | | CALL { | | | | 
 Seaianainneinitie Gubaiabetetaireas Guinietetateeteiaans Coeeretateraietaie Gaetan, Caateeerataen Canennnenitattanen Saameneenenenaaatene + 
| |EDIT | EVENT | | ¢ |EDIT" | | - | 
}-------—- 4-------} ----------} ----------}------— f--------$----------}------—--- +4 
|COMPILER |COMPILER| | | COMPILER 
| TITLE |DATA {PRIORITY |PSEUDOVAR |FUNCTION|DATA' | | PSEUDOVAR' | 
| | | { [COMMA =| | | | 
SRR SRI AAiaSs SESH OLR | RoE eeenmonemas | Crier 1 alee a : aes : alana fae SSS ee { 
J ATTRIBUTES|STRING |REPLY | | ) |STRING' | < | + | 
Psa ee a a ea ee 
| | | | | COMPILER | | | | 
|PAGESIZE |SKIP | | ERROR {ASSIGN | | | NDX | 
ban nn enn fn nf nn nnn fn nnn fn nnn nn fen nnn nnn nn fen nnn enn 4 
| | | BUY | | | MULTIPLE | | | 
| IDENT | LINE |CHAMELEON |BUY ASSIGNJASSIGN |ASSIGN | 2 4< | / | 
on fen pn rn fen nnn nn nnn fn nnn fn nnn rn fen 1 
|LINESIZE |PAGE | | ARCO | DROP | TMPD | LEFT {OFS | 
pean ff nf nnn nnn fn nn nnn fe nn nn fn en nnn fn nnn nnd 
| | COPY | | i it | LD | 45 | A | 
Fe a a a Sea 
| | | | BUYB | | | 
| INTO |KEYTO | |PSEUDOVAR |CALSEQ |TT | | PSEUDOVAR' 
| ------ -$ = f+ fn nnn nnn nnn fen nnn nn fn nn nnn fn nnn nf 
| | | | END | | | | | 
| FROM | TASK |LIST MARK [LIST MARK | | | IMP | = | PREFIX - | 


|---------- }------—-}----------f == =f pnp f= === 


| SET | RPL {IN | FUNCTION [|CNVA [RPL | FUNCTION! | 
}---------- $= J nnn nnn nnn fn nnn fern nnn fn rn nnn fer rn rr rrr = 1 
| | | | ARGUMENT | | | | | 
| KEY | | | MARK | é& | > |PREFIX + | 
an a nnn fan nnn hn nn nth terror rt 
|DEFINED |SUBSCRIPT | [LITERAL |DEFINED- | | 

| NOLOCK |KEYFROM |SUBSCRIPT | | CNVB | CONSTANT | SUBSCRIPT* | SUBSCRIPT' | 
p—- --- fn nf nnn fr rn fern nn hen rrr ten nnn rrr nnn 
[FORMAT | l | [FORMAT | 


| 
| IGNORE {LIST | | | 4 | LIST* | < |  +** l 
bee soe eee eee hoe ee eee hoe Lecce. A ee ee ed De ee oe a a ee eS ee J 
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(tn teemalen ehemetiee alin aioe seen eee win eteein whee we ween een, ein, ein ee | 
I ' J J ' ! { I ) | t | § z | | ' t 
t ! j I ' t ( ' t | t ] t comm | | ! ! 
‘ t § j t ! t t ! ! ' t ! te | | t | 
' t ' ' ' J J ! t ! 1 t ' eI j ' ' 
' } § ! 4 t ‘ ' I t ! | oO | I t t 
‘ ' ‘ | ! t § I | ! ' 1o| iQ J ’ ’ ' 
! ' ' ! ! ’ { ' | ' ' ! ] wn | te |} ' 
! ' ! i 1 fe | | | t ' 1m | ! eo 
’ ! j t= 3 (24 fe | J { IOlwyn | ' ea 
‘ ' ' St (et ret ' t { ! w | 1a | ! 
| an, ! oO 1 t { fe | el oO ! 12 7B | 
| ig] {el fai tet igi [RlBel 818 
oe ed et ne a 
! I j J ! ' | ! ' | ! ' ’ j In I j 
| I i t ! | j ' i} ! { ! ! (Mm | t I 
Yt f ft to t fF torBbr ft rst 1eyer ft 
| | | ! | | | lol Bl | 1g | | | 2 | { 
j I~ | ! § | ' (AIH!) | 1A | iM'iaiwl 
Ce ee lal | 
; jal ft tet £ GBIBIiBi. [2] jBiat | 
I oO} | (mt I (Him iW tol) ee | ( 
papa pa a a pe pp pet 
| ! ' | | ' I t ! ! ! ! | I ' 
! J 1 | J t ' t J | | | J I I ! 
| ] | | t ! j 1 ! } | it | I { | 
| ' | § ' { | | ! pm | 1& |} ! ' | ! 
ft tot ft dot tot t8t tet tet tat 
| ! | I ! 1a | eI | ! 1 & | (mI (o} 
fai iat leiBis Bla lBis/8] [Biola 
ee eo te ia ed 
Yr toy bo ted to to tet ot tet tet tos 
! 1 ' | 1 | fe (Ria! ! fe] (& 3 ! t 
I { ' ! Ni a Pan em ae a ge (<i ee I ! 
fot thi te1gizlg@ifig: 16] Blet 1 | 
te | 1 | Ie 1 OIG Blale | ! j 16) A | ! | 
Papa tata ate pt Ot tt te ted 
ret od dot tet Tot db bot ot totetat 
Wk ale AG Wee i alee 
PAT AE) LE) Ble) a eile le | 
cc a ee Oe ea 
| | | 12 | { ! | | | | ! | | ! 
! tml ' | | $ ! 
I | ' (pt (mi !o |] | ! ' ! an | 1} 
gt eT aT Ligi | tod fd BIRLA IE 
lelSimi@ialSilmio}l | tol | Gialx fal 
tf | | | | Tet tat ted £ ft of t teat 
at ‘lag Vahey fet tei eb ort et 
{2 | 1& | fH IG 1a |S | B | | | | 1 $n | 
te] tet (BUBB ela lB tA! | BLO Lg 
(mI ] ! 1 | ! ! ! ! ! ! ! 
4 (& I t | I | ' ' { | ! ( | ! t ! 
' {<a | | | ' ' t ' | ! { J ! ! | 
{ 1S | | (af ! | | | | (> | ! | ! 
j t (mir 1a) } HiAaic (eI (ae | 
' ted (Miet (<= l ItNQiH tile) [et !o}l 
ole ia lel ef 1a I eo ei ao aa 5B fal ee | 
| (cima { = | (wm | m2) SIaeyar | 4 1 
fee cee ecbee cee alee cme edb mee chee come ane eee oles eee ene cee odes eee othe eee ahs ne eke owe me omee calee ome ane cme enlee emus od 
Co i os i 2 2 <n | oOo A FR 
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4%. FORMAT OF TRIPLES 


The triples produced as output from the 
translator phase each consist of five 
bytes, an operator followed by two two-byte 
fields. Each of the two-byte fields may be 
occupied by an operand, which may be a 
dictionary reference, a code byte or code 
bytes, Or a numeric parameter. Two zero 
bytes in place of a dictionary reference 
operand imply that the operand is the 
result of previous operations, and that its 
type and location are described in a TMPD 
in the text. 


The number of operands and the fields 
which they occupy depend upon the type of 
triple. The following table contains this 
information for all the triples used in the 
compiler. 


ee a eee bg a ee en ay oe pee a Bt sean ae 1 
rears TYPE _ ae 1 — 2 
| | CODE | | | 
ee ee Ce ee 
arr ae aie von) a” “leseaanp 
Secsunes, oe oe Geena | 
acesie Geant topegaan 
se aan rt alee 
fr ees Ce ee a 
Gaerne RGD oe eee a 
(oo eee eos era a a 
PP ence eo ane et 
fc foo, een 
eo (ioe cs fopEsAND. 1 
co ae ee ye 
en ee 
‘ao ee es ee 
or eae ice an ora 
ee ae eae 
us an epee. | 
oa waa Se ee 
ce aa ep ae 
aac ak eeennnD 
oi ee a Se ee eee di 
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T T eo vee 1 
| TASK | 1B I - | - l 
w--=---------2 wf ---4-~-------$------ 4 
[RPL | 1c | i | . | 
~--------------- $----4---------4----~----4 
| IN | 1D | - |OPERAND | 
~----------——--- }----$---------4--------- 
| KEYFROM | 1E | - |OPERAND | 
~---~--~--------4-~--}---------4---------4 
| FORMAT LIST | 1F | - l - l 
}---------------- $--~-}---------4--------- 
| UP | 20 | - |OPERAND | 
ee a ae te ot ee a ee ee ee 4—---~-—4------—-— et cai ee ae 
| GIVING | 21 | - |OPERAND | 
}----------------} ---- }---- ----- 4 ---- === -- 
| DOWN | 22 | - |OPERAND | 
~--------------- $-=--4---------}---------4 
| EVENT | 23 | - |OPERAND | 
~-~----~--------4----}-~-------4---------4 
| PRIORITY | 24 | - l - | 
cnet an am oman att aman an enanen a amen dos area +---------+}--------- 
| REPLY | 25 | - |OPERAND | 
aoe Sa em ee mae ce anes a cm eee ofl as es ee 4+---~------ oe ee ae ee een oe 
|BUY CHAMELEON | 27 | - JOPERAND | 
}----------------}---- }---------4--------- 
{MSA | 28 |OPERAND 1|OPERAND 2| 
}----—-----------}---- }---------4--------- 
[MTA | 29 |OPERAND 1|OPERAND 2] 
}---------------- }----4--------- $--------- { 
| DEFINED | | | 
| SUBSCRIPT | 2E |OPERAND | ~ | 
~----------—----}-------------f---------4 
|NULL-FUNCTION | 2F | - | ~ | 
a 
| COMPILER | | | | 
| FUNCTION | 30 |OPERAND | - | 
}---------------- rr $--------- { 
| COMPILER | | | | 
[FUNCTION CALL | 32 |OPERAND | - 


a ee a | 


| COMPILER | |. | | 
| PSEUDO-VARIABLE | 34 |OPERAND | - | 
|BUY ASSIGN | 37 |OPERAND 1|OPERAND 2] 
pone ann nn fon fon nnn fa 
| ARCO | 38 | - | = | 
| |SUBO | 39 |OPERAND 1|OPERAND 2| 
a= --—---------- + —- fe === 

| PSEUDO-VARIABLE | 3A |OPERAND | - | 
| | SSUB | 3B |OPERAND1 |OPERAND2 | 


~---------------}----$---------}---------4 


| FUNCTION | 3C |OPERAND | - | 
Sn ca ee ie i a ae et ea hs ic as cess sic -----~--~ 
| |SsB° | 3D JOPERAND | - | 
cael evergreen acne aac , pane: Reena : Sea 4 
| SUBSCRIPT | 3E |OPERAND | - | 
FLEE: Sa. Ce aE Ca BET 
| NOP | 3F | = | - 4 
| |PTCH | 40 |OPERAND 1|OPERAND 2} 
ED ee + oe en { 
| COMMA } 41 | - | + | 
hoes cin ne he ae ae ee ee ew a cc oe ee ee ee 4 


*This triple may have two operands in 
format lists. 


rs et rn nn nr 7 


|FUNCTION COMMA | 42 | - JOPERAND | 


~--------—------}----}---------}---------4 


| COMPILER | | | 
|FUNCTION COMMA | 4&4 | - JOPERAND | 


}------------~---}----}---------}--------- 


JACT | 45 |OPERAND 1[OPERAND: 2| 


| ASSIGN 


ae Se Ae ae ES ake eee ee ae ew ES coe eS ee Se ee a ee 


4 
JOPERAND | 


a SD ES AS EP SS EP ND SD GS Ge a a lhe cee EP eee eS a ES GD eas eee ee oe ee a ae 


| CONCATENATE | 49 JOPERAND 1]OPERAND 2| 


wr nn fe - -- f - f+ 


- |BUY B | eA -  |OPERAND | 


}----------------}----}---------}-—------ 


JOR | 4B |OPERAND 1|OPERAND 2] 


}--—-------------}-~--}--------- --------- 


J AND | 4D ]OPERAND 1|OPERAND 2| 


ae nee eee Rosman Heenan 
| NOT | 4F | | - |OPERAND | 
nf ff 
|LIstT* | 52 | - | - | 
JEDIT" | za Z | as | 
| DATA' | 54 | — ‘| - ! 
| STRING' (55{ - js 4 
aor Hf -- $ a aS os cs coe 


| STMPD | 56 JOPERAND 1]OPFRAND 2| 


~--------—-—---}----}--------}--------- 


|MULTIPLE ASSIGN | 57 |OPERAND 1]OPERAND 2] 


| TMPD | 58 |OPERAND 1]|OPERAND 2| 


{----------—------ aa a | —— —— — — —— f 


| IMP | 5B |OPERAND 1]OPFRAND 2| 


}-------~--—-~~--}----4----~----f --------- 
| RPL* lsc} - | - | 
~------~--—- --- - + --—— --------- a ee eee 


| LITERAL CONSTANT| 5E | - JOPERAND | 


~--}---------}------——- 


| FORMAT LIST‘ | oF | - | = | 


}DO EQUALS | 61 |OPERAND 1]OPERAND 2] 
~=-~---------—-4--—f --------}-------- 
| DOWN | 62 | - | - | 
| ERROR | 63 | - | - | 


Se a ee ee 


| UPSIDE-DOWN | | | 
| COMMA | 64 |OPERAND 1[OPERAND 2] 


| LESS/EQUAL | 65 JOPERAND 1]/OPERAND 2| 


--~—---~ ~--—----— $-- -—-$------- --}--------- 


{GREATER/EQUAL | 67 |OPERAND 1|OPERAND 2] 


-----—-----—---- - f-- —— $ - —— -- -~ -- f --- --- - 


| LEFT | 68 |OPERAND 1|OPERAND 2] 


on - - -  - - - $ -- -- $ - - - -- - a a oe a 
[NOT EQUAL | 69 JOPERAND 1]OPERAND 2| 
---- ~~ ee em cs i eS es an eee 
{ EQUAL | 6B |OPFRAND 1]OPERAND 2| 
aaa — $+ eS 
| GREATER | 6D |OPERAND 1]OPERAND 2| 
scr ms as a ic a scutes cs se 1 een Keene en nee! | 


| |OFs | 78 |OPERAND 


we were eee Sah Sateen ientetetetetetatete desteieteteteteteten | 
| DEFINED | l | 


| 
| SUBSCRIPT’ | 6£ |OPERAND | - | 


}----------------}---- $---------}--------- 


| LESS | 6F |OPFRAND 1|OPERAND 2| 


| COMPILER 
| FUNCTION 


t 
| COMPILER 
| FUNCTION CALL' 72 |OPERAND 


-- ~~ -- - f - - - - - -- - - f+ + 


| MINUS 73 |OPERAND 1|OPFRAND 2] 


om ee ae are ewe ee ee ee ee ee oe ee re eee 


t 
' 
1 
i 
1 
1 
i 
f 
1 
I 
i 
1 
1 
—+ 
i 
! 
! 
1 
l 
1 
1 
! 
—e 


| COMPILER 
| PSEUDO-VARIABLE' 


| 
74 |OPERAND | - l 


+ 
75 |OPERAND 1|OPERAND 2| 


! 
1 
! 
' 
+ 
{ 
' 
1 
' 
{ 
t 
| 
{ 
' 
{ 
{ 
I 
' 
! 
I 
{ 
I 
t 


+ 4 
JOPERAND | 


| DIVIDE 77 |OPERAND 1]OPERAND 2] 


}----------------}----}---------}--------- 


| 2 | 
ne ee eae ete ey Serene eee: ee Some ae 


| MULTIPLY | 79 |OPERAND 1]OPERAND 2] 


+ — + — + — H+ 


F + + + 
| PSEUDO-VARIABLE'| 7A |OPERAND | - 


Sheela sea aoe Sees Sor Pi ea eS 
|PREFIX MINUS | 7B | - {OPERAND | 
warn nnn fe nnn for nnn ff 
| FUNCTION' | 7¢ |OPERAND | - | 
a a a re dw a oS a —--- 4-----~--- Se ne a en 
| PREFIX PLUS | 7D | - |OPERAND | 


~--~------------4----4---------4------ 4 


| SUBSCRIPT | 7E |OPERAND_ | = | 


}----------------}----}---------4--------- 


| EXPONENTIATE | 7F |OPERAND 1]OPERAND 2] 


}----~-----------}---- f---------f---------f 
[To Feo fo = fo 
~-----=---------}--=-}---------$---------4 


| ALLOCATE | 81 | - JOPERAND | 


}----------------4+---}---------}---------4 
[BY fez} o- | - | 
}----—---------------}--------- 4 -------- 


| FREE | 83 | - JOPERAND | 


f }----+ + 
| WHILE | 84 JOPERAND | - | 


2 - -- ---- + ~ + ff + ee ini co a os ce em 
| | *cv | 85 | - JOPERAND | 
—---——---- -—---—-—- —-~ }- --- } --------- ae as ee ee 
| SNAP | 86 | - J|OPERAND | 
a - ~~ - - 4 ---—- f+ - - - --- -- Sat ee 


| DELAY | 8B | - |OPERAND | 


jcv | 8C JOPERAND 1|OPERAND 2| 


SE 


| EXIT | 8D | - | - | 


4 
| 90 | - JOPERAND | 


~--}---------}---------4 


|END ALLOCATE | 91 | - | - 
f----------------4--—-4---------4---------4 
| PAGE | 92 | - | - 


+ =| 
| 94 | - |OPERAND | 


ae ee 14. ——— 1... ——-— —--4— ~~ - -—-~~J 
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Le ne ke keen teen ate. alee tale atone alee oheede steele Steen ein eles eens Oe Dien alee Wine eee eee eee Sian See Sa 
tee ene ae ae dae ae a ade iedeta tall 
t ! eo ee eae ee 1a | t I ' I | \ t ' I | | | { lelelelele! | | 
{ 1 (212 1 (21 2aiaeal iat | | ! ! \ { I { ! | I ! { | ! (a I ! 1rd ! 
aa a Oe ee ee ie re a aa tid 
SU TetRiB Bere ey rd ty bt et do gt ty TRIB UB leit ot | 
! | (&iatia tla tate) 1 | ! ! I ( \ I | | { | t | lo tato tala | | i 
i t tororor1rot1orol tO 4 ft ¢ F § Ft t toh F bei bi t FOoOtToror1ol1olt | § 
pa tt Ht tt tt tt tat ta te ta tt tae tee te tat ett 
! ! Ind fet | jet | | ! 1 | ! ! t ! \ ! ! ! \ ( { ! I ! ! ! 1 I ! | ! 
{ t t | | ' ' t ! i ! ! 1 t t | ! | { ! | { | | | ! | | | ! 1 | 
! ! Cae 1a t ! \ { ! | ! ! | | { 1 I | I 1 I I | { | { ! 1 ! 
| ! | {at [a | $ ! ! | ! t ! { I 1 ( | t { | | 1 | { t | t {pl { 
ae Oia fa a ee a ee a a ae tol 
| ! | 1m | | | ! t { ! ! 1 | { 1 | | i ! ! | | | ' I ! t I ! { | 
{ | 1 Gi | I 1 fa | ! ! { 1 { { I | ! | { | | ! l | { { { | ' t | 1 \ 
{ I 1A. | A | 1oot ! | ( | | { | t { | { | { ! 1 | ' ! | | | | | ' ! 
' | toto !ol ' ] ! ! I { ! | { am eee ! I | { | { I | one See 1 1 
eee ae 
1 
I~™MIMNIPOITOTHIAIMIF IN POINTWMIDIGINIAIBx Halt I! sim tAaraldtinimintianta 'o& | 
Isiolylgiatiaials |e (ein le lag IS lQIBIB AIS IBIBIAIRIBIB IE ISIE Ete | 
| ( I 1 ' ! t | ! § | { ne 93 { eed | { be seauel ! | ! 1 { ! ! I ! ! 
foe mee me et a te a te tt ae tae ter st et ote ee a tt tae tae tt 
{ | { $m f ' | ' ! ' 1 { | 1 I ! ! 1 1 I ! | { | | ! ! | I ! 1 ! 
! | | 1 | fol (ma | | ' | ' ' \ | | { ' ! ! ! { | | ! | ! | ! ' { 
I t t 1a {| {at tt ! ! | | ! | { { { { | { I { ! ! | | ! ! ! 
I \ { ex (at i ! 1! 1 ! ! { | | ! 1 | 1 | { 1 | | | le | | | | ! 
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{ ! { iz] fei | ! ! ici | | { 1 ! I | { | | | { ! { | 1a | | ! ! 1 
{ | | ! { { { 12 Ie | | ! { { | { { | | | { In I | I t ! I | | { 
! | ' le Ie | 1 ! 1 ! 1 J 1 ! | { ! 1 ' | is | | { j te Iz | J ! 
! I t I | (2 (al iam i ! 1 ! | I ' | ! | {oO lolly t ' t | to | | i 
tt tg tee ey ey tote} VELL twlel TETBTEISH. fe l8] telelei 
| & | | | | bh tH} 1H | | 18 | Le | | lea te. | Pale Ia TAT. let | [Sie | | 
ee (eine (HIN ITA! Le | 1S | ie ig | teat ! ! | 1 eae | I 1 ff | 
ISI SSR ta EtG RIEL eee ete eee eee IE IQ IRIEL E | 
feIGi Prelate ta oe OTe IRIE IE IBIBO IBIGIAIB IAB lala ia lalBlaia te | 
ee cower cele eee eee ee eee cee eal cee eelen cee eal cee enh cee bee ee enh cece eons comee aol coon een emeee cohen cee cod cameo collee comer cole cence whe come dies eens cathe eres ale wee en emo che ome ew cee hen comme ele commen endless edie comme eolbee ores een ener oclhes em oad 
ye cr a TT ee ee 
| ! ! t J t t u | 1 I | | | ! ' { InN ITN | t | | | ! ! i InN] '. 4 | ! in | 
' { | ! | j | ! | ! ! ] ! ! ! | | | | | { ! t | | ! | l | ! | | | ! ! 
fa tratiatl 1a I ta PIB tS Bieleis Pie P|. a'iglatralgaia! 1 pa iatiatatiatatatl 
(2142 124 1 (2 1 ! 1a i Iai i 1a | ial 142124 | I24IiZ2I1I2i1f21414 } j IZ2IiS1i 4atiaialtaia il 
Ne eh et ee ae el Isis isis is (sis isgisisisisgigigt' |'[eiegieielereial 
ime lamain i Pe ! $a | a / ! | 1m | { { 1% | (Gimil 1a 1m | | ee ae = ! 1% | 
(ete | | | ! i& Ik I | ee Oe eS I [ei | I ie ieaiel 
S{SiSt 181 ft (SIS SiS Spe S te Sols sess ls isis: | 1818181818 1818 | 
SIs GZ SS me Ke Cans Is cae DS Se SE Bo SI A ee I 2, Ve eee cee oe ee ee 
r tf ¢ t F Fd F FF bP bP bt bf Po bP bt bf ob tebe ot ot bo be db bt bt det ot le 
Pe i i ee ee de Ae ee arte atte oa Seeger Agel 
eee ta Ea ato ae ae teed ath gc hale lad ish (aict wr hee eke ae bata) ay || 
eS oie ae tate ae ae eee ee 
| { { 1 1 t | | | 1 { I { { { { I { (af I { | t 1 tote ta | | | 1 { 1} 
! | { { ! 1 ! | i { ! ! { 1 { 1 ot { 1oO | I 1 ! ! I po+1ro1iot | J ! ! 1o | 
lee: oben bade lee de lec bor tale te lan erle: beberle be tola le lerlecdwd ectote Pola tke be: bello 
a aaa a a Fe aaa a ee 
fa mm a ta te ta tat ta tte th ta ta ta te tte tae tert nt 
( ' | ! | | | | | ! ! | i | ! I | | | | | | ! ! | | | i | | | 1 ! { { 
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' ! ! ! { ! ! ! ! ! ea I { | | | | | ' | I ! | | ! | ! | | { 
1 ! 1 | | | ! ! I | 1 | { ! | { 1 | ] I { ! I | | | | ! | { | 1 
! | 1 I | ! I ! ! ! ! | | i | | | | | ! ! | ! ! | H et { ! | ! ! ! | 
eee ee eee eee eee ee ee a ee 
t J ! ! ' ! ‘ J t ! j t 1 | i | | ( { ! j I I | ! {fl ! ! j t | i ' | 
Pestotecale thet 4 Sh Ste ops Weed: ae a ie ese A aie ed Atte ea | 
(qiaiewl (& I { { ! { ia | let I I | | | { | | ! | | te | I | {Oo Pe | ! fe | 
fet fet ol 1m 1 | | ! | 1% 1 12 | 1oO | | ! tril | t | { (2 ial | I is | | | ime t 
(Pe 1oIa | 1 | ! I iH | {Pl {oO | oe ie © ae oe eee ! cee ee ec ! | H ! ] 1 an 
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5. TEXT CODE BYTES IN PSEUDO-CODE 


0 1 2 3 4 a) 6 a 8 9 A B Cc D E F 
Carreras Canaan onacaties Se or Pe ee Be ne ee ae fa Ee ae ee ay 
0 |DCVO |OSM1 |BGPE |BLBS |LCR |LCDR|LCER|LM |BCTA'|LH |LA |CLI |CLC |TR } |INST] 
po-- 4-4 fof nn ff nn pa fp on fn penn pone penne tf 
1 |DCV1 |OSM2 |EOB {|BLBS'|BCR |SPM [CLR |SLA |BC |CH |CL |MVI |MVC |TRT | |MVCL] 
}~----4------4-----}----- + -------4----$---- f-----$ = ff ff ff 
2. |DCV2 JALLOC {PCC |BUYS |HER |LTR JALR |SLDA|DCF {AH |AL |NI  {|{MVN [PACK | | | 
Sesh SASS SSEPESpa Gu Satah Senet Sapataind evabated usepaten jubseeates Seetaien Seehaneh eetemnat deers stot oeeten tanat terete 
3 |DCV3 |DCA3 |CHSM |PINS |HDR |LTER|SLR |SLDL|BCTA [SH |SL |OI |MVO JUNPK |[ | | 
~---~}~-~---}-~--- 4 ---—— f---- f----f ---- ff ----- ff f= f= fe ff 
4 |DCV4 |DCA4S {ADR |[RWA  |BCTR|LTDR| {SLL |BCT |MH |STC {SSM |MVZ |IGNORE| | | 
p-----4~-----4-----}----- }----4----4---- 4 ----}----- + - f---- ff ff 

5 |DCV8 |FREE |SN3 |APRM |NR- |LNR {LPR |SRA |N {STH |ST |T™ [NC | | l 

[--~--4-~-——-f----- 4 ~~ ff ff fff fn fo ff ff 

} © [DROP |BUY  |BCIN |USNG JOR |LNER|LPER|SRDA|O {QLA [EX |XI  |0Cc |CcOoNVv | | | 
}-----4------}---—- | ---- | ---} ~~~} -- = } -—f -=- f--f nn fn f == fff 

7 |EQU |SELL |STOP |EDIT |XR_ |LNDR|LPDR|SRDL|X |STD |STE |LA* |xc |CcONVv' | | | 
}~----}--—--}-----}-----4----}----}--—- f----}-----4 ---- f---- f= = fo fff 

8 [PROC |PROC' |BGNP [FMT {LR [LDR |LER {SRL [L {LD |LE |DCF2 |ZAP |USSL | | | 
| | | {LST | | | | | | | | | | | | | 
}-----}~-----}-----}-----}----}----}---- 4 ---- 4 -----f ----f---- f= f= ft fd 

9 |BEGIN|BEGIN'|BGNP'|FMT |CR [CDR |CER [STM |C |CD |CE |BCT* |CP |DRPL | | | 
~----}--—--}----- }----- 4 ----}—--f -- f= ff =f ep pnp etd 
[4 |PASS [ADV |DROB'|FMT' {AR {ADR |AER |BXH |A JAD |AF |MDRP JAP |CNVA | | | 
~~ --4--—--- $+ === f= f= ef ft it npn fen tenn etd 

B |EOP |PLBS |PLBS'|EDIT'|SR |SDR |SER |BXLE|S |SD |SE | |SP |SINL | | | 
~~~} --—--}----- f= fp ep nn ft an nnn tenn penne tee 

C |ECP2 |PCBS |PSLD |ERROR|MR {|MDR |MER |SL1 |M |MD |MF |SN2 |MP |CNVC1 | |IGN2| 
~----}--—~-}----- f----- fff ft tte ee ft 

D |IPRM |IPRM' {ABS |PFMT |DR |DDR |DER [SN |D {DD |DE jOSM3 JDP |CNvc2 | |{IGN4| 
f-----4------4-----}---—- }---- }----f- -4 --- f- t - - -  - 

E |EPRN |EPRM" |ABS' | |SVC |AWR |AUR |JCL1 {Ic |AW |AU |EQU' [ED |CNvc3 | |IGN5| 
}-----}------4-----}---—}---- }----t----}---------F---- 4 --- ff ---- + ----- 4 ---- 

F |ITDC |ITDO* |ALIGN| |BALR|SWR |SUR [CN |BAL |CVB |CVD |BSW |EDMK|CNVC4 | |IGN8| 
bate eS f CNC Cee SEEN eS eS. DAME reeY MeneeAane keer! SRRTEY Eee: ESOC NEN OREGMNRION, CESOieeny Reiaiee aare wey Deen Yeh meen 

6. TEXT FORMATS IN PSEUDO-CODE The format of the various pseudo-code 

units is as follows: 

Pseudo-code Design Three-byte unit: this consists of a 
one-byte operation code followed by a 
two-byte literal offset, and it appears 
immediately after the symbolic 

Pseudo-code is essentially a symbolic representation of the instruction to 

representation of machine code, designed in which if refers. 


such a way that it is possible to directly 


transform it into executable machine code 
by an assembly process. Five-byte unit: there are four basic 


five-byte units which have the 
following formats. 


A unit consists of a one-byte operation Bytes 0 1 3 
code followed by, normally, a two or t------- Y---- roo 1 
four~byte field and on the other occasions | OP ty aE | R2 | 
by a variable length field. The bit. | | R1 | 
pattern of the operation code indicates the | CODE | 0 | DICT REF | 
type of unit which it heads. t_—————-—4-~-~~~--~----—1----—--------J 
Bytes 0 1 a 
Se ee ee ee en ee ee ee 
By having most units either three or | OP | | | 
five bytes long, the scanning of | | R3 | OFFSET | 
pseudo-code is a fairly straightforward | CODE | | | 
process. t--—-—-— 1---~—-—---—----~ 4—----——---—--—J 
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1 3 
ener aea as aa aca arar aca eos Sea ee 7 
| OP | | | 
| | R1 | R2 | 
| CODE | | | 
eae Rna Ne etl ea) Rh eral ane por ae a has sae case et J 

Byte 0 1 3 
Cee ee ee ee ae ee ad 
{| OP {| 1 | R2 | 
| | HEX | 
| CODE | 0 | DICT REF | 
Losec eh a ech tog heated ee es J 


Using these units with, if necessary, a 
three-byte unit, it is possible to 
symbolically represent any possible RR, 


RX, 
RS or SI instruction. 


Variable length unit: the format of 
this is: 


Bytes 0 1 3 
esos Se Y Saant is aaa are as 1 
| OP | | | 
| | FLAG | VARIABLE | 
| CODE | | | 
a ac ee re J 


With a specially designed variable field 
described by a two-byte flag, it is 
possible to represent any SS instruction 
with this unit. 


The first byte of the two-byte flag 
indicates the format of the variable field 
and the second gives the length of the 
total unit. 


RX Instructions 


The following examples illustrate the basic 
forms of an RX instruction and the way in 
which they are represented in pseudo-code. 
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L R1,JOE(R3) 


| Bytes 0 1 3 
EO aar, = a Ma Ly cet Pp as oe ope ee ee 
} L i; oO R1 | DR(JOE) | 
Veo doe ee ee as a Ne oa sed ae a 4 
CSS t i Ne ieee  e ed 
{ OSM2 | R3 | 
bow ee hoes Ree J 
L R1,JOE+24(R3) 

| Bytes 0 1 3 
a ce eS gtr et aD pe pee pe ie ae ee 
| L } 0 R1 | DR(JOE) | 
Vee eee bo eee ee) 
Se ee epee ge ne Te ee ny Wp st ere rN 
| osm3 | 24 | R3 | 
to oe dhs a ee d 


Alternatively, JOE might be a base 
register in which case the dictionary 
reference would be replaced by a symbolic 
register. The two forms are distinguished 
by setting the flag bit of the first 
symbolic register equal to one when a base 
register is intended. 


L R1,0(R3,R2) 


[Bytes 0 1 3 
Ce Wee ties ty tre co gees hee et ee 7 
{| L } 1 R1 | R2 | 
Loco aime eas eee eo 2 Sa ee nee J 
Pair Sota re et ee ee 
} OsM2 | R3 | 
toe i a on as ee Se J 


When a branch instruction is generated 
which branches to a compiler generated EQU 
value, bit two of the second byte is set to 
one to indicate that the second field is in 
fact an EQU value. 


L R1,J0E 
| Bytes 0 1 3 
c--cc--—- ges SSS Torr ne | Bytes 0 1 2 3 
[| L | 0 RL | DR(JOED | [------y- ~~ -- y= nn 
Geta ey ileeeecere i et o Exe enna ore J | Bc | 01 | HEX |EQU VALUE | 
toi———-L_—_—— ~-L~~. —+- ~~ 1 ~~ --~—---4 
L Ri, JOE+24 
| Bytes 0 1 3 
frre rn | Bytes 0 al 2 3 
i 1 oOo R1 | DR(JOE) | Se eee ce a ee eee eae ae 
eae Seeieeea eee Deewel Cee eesenon Sarees l [1 l [ R2 | 
Ba erate | Be | Gf HEX. 3 
| osm1 | 24 | 1 0 l | DICT REF | 
(os ee ed L~-~-~--—~— 4————__-—~— Li. ——_— —-——— Lo SS 4 


KS Instructions 


The following examples illustrate the basic 
forms of an RS instruction and the way in 
which they are represented in pseudo-code: 


BXH R1,R2, ALPHA 


| Bytes 0 1 3 
yes cee Wo ne eee ee Bie ee ris fee pe ee ere ee 
| BXH | 0 R1 | DR(ALPHA) | 
bos ls nn a ciara ca oe as eaten dines em crannies enemas anemuson el 

Rea Tint cet Mee te 

| osm2 | R2 | 

[en eee een ne —_—d 


BXH R1,R2,ALPHA+24 


| Bytes 0 1 3 
oe ee ee ere fe re 7 
| BXH | oO “RI | DRCALPHA) = | 
LeewetR ob e ae e ae St See 
See a eh Se ep ee 
| OSM3 | 24 | R2 | 
[SRE Boe ee eae hoa ea ees 


Alternatively, ALPHA might be a base 
register in which case the dictionary 
reference would be replaced by a symbolic 
register as in the RX instruction. 


SLA R1,6 

| Bytes 0 1 3 
ee 
| SLA | R1 | 6 | 
Reo SS ee ed 


RR Instructions 


The following example illustrates the form 
of an RR instruction and the way in which 
it is represented in pseudo-code. 


AR R1,R2 
| Bytes 0 1 3 
map + = - —-—~-  - —— -- ----- ——- 7} 
| AR | RL | R2 I 
Misi ere a ce eS ee 


SI Instructions 


The following examples illustrate the basic 
forms of an SI instruction and the way in 
which they are represented in pseudo-code: 


CLI BETA,X‘FF* 


| Bytes 0 1 3 
aa SS arp an may ee rN ea a 
| CLI | 0 FF | DR(BETA) | 
bee ee dn ee wen roe wom i... J 
CLI BETA+4,X'FF* 
| Bytes 0 1 3 
| CLI | 0 FF | DR(BETA) | 
bee , 4. J 
we ranted? Na oe ews ee eee 
| OSM1 | 4 | 
De ee ee be a ee ee B | 


Alternatively, BETA might be a base 
register in which case the dictionary 
reference would be replaced by a symbolic 
register. 


SS Instructions 





Basically, an SS instruction consists of 
two base registers and a length byte. 

Since this does not conform to the format 
of other items of pseudo-code, it is 
necessary to represent an SS instruction 
with a variable length field, the length of 
which is specified in the second of two 
flag bytes immediately following the 
operation code. 


This variable form of pseudo-code will 
be used to convey items of information 
internally between compiler phases, at the 
same time maintaining the -items in the 
guise of pseudo-code. 


Variable Length Item FLAG 


The first bit of the FLAG indicates whether 
or not the unit represents a machine 


instruction. In the former case, the 
format of the instruction is: 
| Bytes 

0 1 2 3 4 6 8 10 

ere Can: cme Dae aera: eae Sabet area | 

| OP | | | | | | 
|FLAG|LENGTH| Fl | F2 | F3 | F4 | FS | 

| CODE] | | | | | | | 
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The format of the FLAG is: 


Bit Zero One 
0 Always zero 
1 F2=dict. ref. F2=sym reg. 
2 F3=dict. ref. F3=sym reg. 
3 F4 not present F4& present 
4 F5 not present F5 present 
5-7 Not used 


The FI field is identical to the length 
field in the SS machine instruction. The 
field contains one or two lengths which are 
each one less than the corresponding 
lengths used in Assembler Language. The F4& 
and F5 fields contain literal offsets. 


Compiler Function (Bit 1=1) 


In compiler functions, the format of the 
FLAG depends on the operation code. Thus: 


T T q 
| CONV | FLAG | LENGTH a F1 ] F2 | 


LL ~~~ 1L---+ ~- ~~ 1 bs 


The format of the FLAG is: 


Bits Both Zero Both One 


0 Always one 


1 and 2 Fi=dict. ref. F1=TMPD operand 


3 and 4 F2=dict. ref. F2=TMPD operand 


5-7 Not used 
The FLAG in the IGNORE item does not 
contain any information. 


The following examples illustrate the 
basic forms of an SS instruction and the 
ways in which they are represented in 
pseudo-code. 


MVC ALPHA(7),BETA 
| Bytes 0 1 2 3 4 
piece tea eee 
(mvc]x'00'| 8 | 6 |DR(ALPHA)| 
benz wea ea ee 
| 6 
potesess 
[DR (BETA) | 
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ZAP ALPHA+3(14), BETA(6) 


| Bytes 0 1 2 3 4 


| ZAP|X'10"{ 10 |13 5 |DR(ALPHA) | 
Cee be ed es he 
6 g 


| DR(BETA) | 3] 


MVC ALPHA(6), BETA+11 


| Bytes 0 1 2 3 4 


nt gp em ee ee ee ee pe re we ge oe ee ee ee ep ee oe ee ee owe oe ee 


[Mvc|X'08'{| 10 | 5 |DR(ALPHA) | 


LoL. ~L be hd 


AP ALPHA+3 (14) , BETA+11 (6) 


{Bytes 0 1 2 3 4 


JAP [X'18"| 12 [13 5 [DR (ALPHA) | 


Alternatively, ALPHA and/or BETA might 
be base registers, in which cases, the 
dictionary references would be replaced by 
symbolic registers and the FLAG byte would 
be set accordingly: 


MVJO ALPHA(14%), 11(6,R1) 

| Bytes 0 1 2 3 4 
7 y SES Seater: Sanaa baiacion Sate iraian 
jMVO|X'28"| 10 113 5 [DR (ALPHA) | 
took Poe as We ee es 

| 6 8 
 ainimeaaaa inane | 
| R1 { 11] . 
Pisa ee 


Pseudo-code Format between IEMRA and IEMRF 


Fields that may hold a dictionary reference 
Or register number have, at this time, the 
possibility of holding a literal offset. 
The presence of an offset is indicated by 
the first pit of the field being set to 
one, and earlier flags being set to 
‘register. ' 


7. TEXT FORMATS IN ABSOLUTE CODE 





Where a standard set of assigned registers 
is to be used for a section of code, e.g. 
in the construction of prologues, or during 
the generation of addressing instructions, 
it is possible to generate instructions | 
with registers in absolute code, instead of 
the normal pseudo-code two-byte symbolic 
registers. (See "Text Formats in 
Pseudo-Code" in this Appendix. ) 


sections of absolute code are preceded 
by ABS markers and followed by ABS’ 
markers. The operation codes are the same 
as the normal pseudo-code instructions (see 
“Text Code Bytes in Pseudo-Code”" in this 
Appendix), but the instruction formats 
differ, as shown in the following examples: 


RR Instructions 


| Bytes 0 1 
SSS ee ee een 
| OP CODE | R1 R2 | 
Ree RD RED ane etn 
RX Instructions 
| Bytes 0 1 2 
Ae Re CET ES ME eee Se eA ee ASE ee ae en ee a ee ets ee pera: | 
| OP CODE | Rl x2 | B2 | 
Nase eee dae ee ea 
3 
poo 
| BICT REFCE 1 
Be 
0 1 
a a 1--------4 
| osm2 | OFFSET | 
bene oT Ree Ryan ee a J 


SS Instructions 


| Bytes 0 1 2 3 
Soe ae > GD DEaais daecnierk: Vargo aren eden ead. | 
| OP CODE | LENGTH | Bi | DICT RBFCE | 
Wa oo oe 1 aes RE he ee! ecaiea 
| 5 6 
(ott es ane 74 
| B2 | DICT REFCE | 
beth ee ee J 
| 0 1 
+ = =s—=-== 
| OSM1 | OFFSET 1 
| 0 1 
RUSE Coniamianierenice tas q 
| OSM2 | OFFSET | 
, cae PE Conn Se een eee 
RS_Instructions 
Shift Instructions 
| Bytes 0 1 2 
S33 =5 553 SS oS = 5 
| OP CODE | R1 O | OFFSET | 
Rieter ie eee a Bd 
Other Instructions 
-| Bytes 0 4 2 
oe a pr en ng wee 
| OP CODE | R1 R2 | B2 | 
eR ances fad Rear bo tS $e 4 
| 3 
| DICT REFCE | 
ee eC NS, | 
| 0 1 
a ee ee eee 
| OSM2 | OFFSET ! 
beeen yf ane ee a 4 
SI_Instructions 
| Bytes 0 =! 2 3 
en eee eae : » Seeman SACamNRR Sia neces 
| OP CODE | MASK |B1 | DICT REFCE i 
an ee te oe ae rae Be Ss ee eA a. J 
| 0 1 
RAPS: susie casi iretataed 
| OSM2 | OFFSET | 
bon eeoee ee hoo ae 


Note that the OSM1/OSM2 markers and their 
following offsets are all optional; note 
also that the OSM2 byte does not have a 
register following it, as in normal 
pseudo-code, but a literal offset. 
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The first bit (bit 0) of the byte 
containing the base is used as a flag. If 
this bit is a one, the following two bytes 
contain, in their low order position, a 
twelve bit offset, instead of a dictionary 
reference. 


After Phases RA and RF all instructions 
in the text will be in absolute code. 


8. SECOND FILE STATEMENTS, AND THE FORMATS 


OF COMPILER FUNCTIONS AND PSEUDO-VARIABLES 


Second File Statements 


Any expression occurring in an attribute 
must be put into a form which is acceptable 
to the translator phase. This means that 
it must look like a source statement. To 
comply with this, all expressions dealing 
with array bounds, string lengths, 
DEFINING, and INITIAL value iteration 
factors are converted into assignments to 
function references. These functions have 
a soecial meaning. They are not entered in 
the dictionary, and their dictionary 
references are to a region in the 
communications area. The pseudo-code 
physical phase dealing with each particular 
function generates in-line code instead of 
a function reference. 


All the statements of this type are 
generated in the source text after the end 
of the original source program. They form 
a second program and are referred to later 
as the “second file." 


The statements generated have the 
following cverall format: 


Byte Number Description 
1 Code byte SN2 
2-3 Dictionary reference 
4 Options byte 
5 Statement type merkers 


6 onwards Statement body 

The dictionary reference is the 
reference of a second file dictionary 
entry. This is described in Appendix C. 
The options byte is that for the options 
operative in a prologue, i.e. no 
interruptions are accepted. 
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Array Bounds 


The format of the second file statement for 
array bounds is as follows: 


Byte Number Description 


1 Assignment statement marker 
2 Code Byte x‘'0Oo° 

3-4 ADV code X*'0002' 
5 


Compiler pseudo-variable 


6 Left parenthesis 

7 Code byte x‘'00' 

8-9 Dictionary reference of 
array 

10 Triple operator code byte 
x'4uyt 

11 Code byte X'5E* 

12 Code byte xX‘'00' 

13 Code byte X‘'00" for lower 
bound, X‘°01' for higher 
bound 

14 Number of the dimension 
whose bound is referenced 

15 Right parenthesis 

16 Triple operator code X'46' 

Liew. Expression for bounds 


Statement terminating 
semicolon 


Multiplier Function 


Multiplier function statements are used to 
denote copying of a section of one dope 
vector into another. The format is: 


Byte Number Description 
1 Assignment statement marker 
2 Code byte X‘'00° 
3-4 MTF code bytes X‘'0010° 
5 Compiler call marker 
6 Left parenthesis 
7 Code byte x‘*00' 


8-9 Dictionary reference 1 


10 Triple operator code byte 
x*4ayqs 

11 Code byte X‘00' 

12-13 Dictionary reference 2 

14 Triple operator code byte 
x"ay' 

15 Code byte X'5SE‘ 

16 Code byte X‘00' 

17-18 offset 1 

19 Triple operator code byte 
x*4q? 

20 Code byte X'‘'5E* 

21 Code byte xX‘00° 

22-23 Offset 2 

24 Triple operator code byte 
x*ays 

25 Code byte X'5SE’ 

26 Code byte X‘00' 

27-28 Length 

29 Right parenthesis 

30 Statement terminating 
semicolon 


This statement requires the number of 
bytes specified by the length to be moved 
from the dope vector of the item at 
dictionary reference 2, starting at an 
offset of offset 2, to the dope vector of 
the item at dictionary reference 1, 
Starting at an offset of offset 1. 


String Length statement 


The string length statement is used to 
initialize the maximum length slot in a 
string dope vector. The format is: 


Byte Number Description 
1 Assignment statement marker 
2 Code byte xX‘00° 
3-4 SDV code x‘0004' 
5 Compiler pseudo-variable 


6 Left parenthesis 

7 Code byte x‘'00' 

8-9 Dictionary reference 

10 Right parenthesis 

11 Triple operator Code x'46! 
pes Expression 


Statement termination 
semicolon 


The dictionary reference is that of the 
item whose dope vector is being 
initialized. If the expression is defining 
the length of a string being returned by an 
internal function, then the dictionary 
reference is that of the entry type 2 
belonging to the label. In Figure 6 the 
reference is to B or C depending on whether 
the statement appeared in a PROCEDURE/ENTRY 
statement, or an ENTRY attribute. If the 
item is a data item, an external procedure, 
or a formal parameter entry point, then the 
dictionary reference of that particular 
item appears in the statement. 


INITIAL value statements 


INITIAL value statements are used to 
initialize a vector of storage used to 
contain iteration factors. It is implied 
that the value of the expression must be 
converted to type integer. The format is 
as follows: 


Byte Number Description 


1 Assignment statement marker 
2 Code byte x*00' 

3-4 IDV code 

5 Compiler pseudo-variable 

6 Left parenthesis 

7 Code byte x‘*00' 

8-9 Dictionary reference 

10 Right parenthesis 

11 Triple operator code X"46° 
12... Expression 


Statement terminating 
semicolon 
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The dictionary reference is to the item 
being initialized. The integer is the 
number of assignment statements of this 
type, and for this variable, that have been 
generated before this one. 


Second File Statements for BASED and OFFSET 


A statement is generated for a variable 
which is declared BASED with its associated 
pointer given, and for a variable which is 
an OFFSET with its associated base given. 
The format of the statement is similar to 
that of the INITIAL value statement except: 


Description 


3-4 PEXP code (BASED) X*'0016' or 
BVEXP code (OFFSET) X'0017' 


Byte Number 


12 Expression (which must be a 
single dictionary reference 
of the associated pointer or 
base) 


The dictionary reference in bytes 8-9 is 
that of the BASED or OFFSET variable. 


Second File Statements for DEFINED 


Second file statements are generated when 
an expression is associated with DEFINED, 
but the expression does not contain any 


iSUPS. The format is: 
Byte Number Description 
1 Compiler assignment 
statement marker 
2 Code byte X‘00" 
3-4 ADF code; 
X'0011' for base only 
X'0012° for subscripted base 
X'0013' For base with iSUB's 
5 Pseudo-variable marker 
6 Left parenthesis 


Base7and subscript list 
Right parenthesis 


Statement terminating semicolon 
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9. PSEUDO-CODE PHASE TEMPOR/ZRY RESULT 
DESCRIPTORS (TMPD) 


Temporary Description Stack 


All information on temporary results is 
contained in this stack. Each item in the 
stack consists of 10 bytes. A maximum of 
200 items is allowed. 


Byte 1 Flac 1 describes the addressing 
method contained in bytes 
5 through 10. 2 bits in 
this byte are also used 
during the release of 
temporary results 

Byte 2 Code 2 describes the radix, 
scale, mode, string type 
etc. of the temporary 
result. The format of 
this byte is identical to 
the similar byte in the 
dictionary and the DED 
used by the Library 
subroutines. routines. 
(See “Data Byte" in 
Appendix C.) 

Bytes 3-4 P,Q describes the precision 
and scaling of arithmetic 
type results 

Bytes 5-6 BASE in one of the following 
forms: 


1. "Reg by value" 
register containing 
the result - no index 
or offset is allowed. 

2. “Reg by value" 
register containing 
the base address of 
the result stack 

3. Offset from beginning 
of current temporary 
storage for results 
held in the temporary 
storage stack 

4. Dictionary reference 
which specifies the 
base address of the 
result of a subscript 
calculation 

Byte 7-8 NDX in one of the following 
Forms: 


1. Symbolic indexing 
register for BASE type 
2 and 4. 

2. The number of bytes 
required in the 
temporary core stack 
for BASE type 1 


Bytes 9-10 OFS which is a literal offset 
to be inserted in the 
base address. When used 
with BASE type 1 the 
actual temporary offset 
is the sum of the offsets 
and the number of bytes 
required in the stack is 
the sum of the contents 
of OFS and NDX 


Strings are described in the following 
ways: 


If the string is of fixed length less 
than 256 bytes, it is given storage in 
the core stack. This type of string 
has a dictionary entry if it is passed 
to a subroutine. 


If the string is of variable length or 
longer than 256 bytes, the storage is 
bought and sold when required. This 
type of string always has a dictionary 
entry. 


If the string has no dictionary entry, 
it is described by the usual CODE 
bytes, the temporary core offset in 
BASE, and the byte length in NDX. 


two pointers: PSTK and LSTK. 


next item to be released. 


If the string has a dictionary entry, 
it is described by the usual CODE bytes 
and the dictionary reference IN BASE. 
The dictionary entry describes the 
location of the string which may be 
either the temporary area offset and 
Size for the first type, or a BUY 
statement for the second type. 


The ‘top’ of the stack is indicated by 
PSTK points 
to the 'physical’ top of the stack, which 
is the last item added. LSTK points to the 
*logical' top of the stack, which is the 
The difference 
is necessary because the temporary storage 
stack may not be released in the same order 
as the description stack. When an item in 
the description stack is released, the 
corresponding temporary storage may not be 
at the top of the stack storage. As the 
storage stack is always released in order, 


the description is flagged and the LSTK is 


reduced by 1 item. When the corresponding 


temporary core is released from the top of 


the storage stack, the description is 
completely removed from the ‘physical’ 
stack. 


as —— a ae ea ee ee ee en 
| | | {Whether F7| | 
[FLAG | F5 | F6 japplicable| Comments | 
‘yPout |piseicnary t ra i: Yes z 
| . {reference | } | | 
|X'O2"|Dictionary | - | No |STRUT2 output -- must SELL dictionary ref. | 
|xeference | | | | 
{X"O4" [Dictionary | - | No |REPEAT function result. | 
| jxeference | | ! | 
|X'O5*|Dictionary |Dictionary | No |SUBSTR function result. { 
jreference? |reference? | | | 
{X°20" {Dictionary |Index | Yes {Arithmetic subscript, or SDV for varying | 
| jreference |register | {string subscript. | 
|X°41° |Symbolic {Dictionary | Yes |Non~adjustable fixed string subscript, with | 
| jxregister jreference | | DROP in STRUT2. | 
|X°49* [Symbolic [Dictionary | Yes jNon-adjustable fixed string subscript, without] 
{register |reference | {DROP in STRUT2. | 
{X'80* {Register | - | No {Item in register -- F7 cannot exist. | 
|X*CO*{|Workspace | - | Yes | | 
joffset | | | ; | 
|X°C1L*|Workspace [Dictionary | Yes {SDV for adjustable fixed string subscript. | 
joffset {reference | { | 
[x'C5*|Workspace [Dictionary | No |SUBSTR pseudo-variable result. | 
| joffset {reference | | | 
}-----4------~----1---------—— a Aen aie eon hs aN a ei rier 4 
{Notes 1. Since F6 cannot be used for both an index register and a dictionary 


| >. 


Many other bit configurations in the FLAG byte are meaningful and could 


| 

| reference, bits 2 and 7 of the FLAG byte cannot both be 1. | 
| 

| 


| be used for future applications. 


Figure 12. 


Temporary Descriptions in Pseudo-Code -- Use of TMPD Triple Fields F5 and Fé 
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Temporary Descriptions in Pseudo-Code 


Descriptions are passed between pseudo-code 


phases usina two or three TMPD triples, 
with the following formats: 


CS ee ee a a OR ie ee eee 

| TMPD |FLAG| F2 | F3 | F4 | 
}------4+----4----}---- 1 --——-—} 
| TMPD | F5 | ¥F6 | 
aon} ~~ - f-------- 4 
| TMPD | F7 lL: | 
LW be Ld 


1. FLAG describes the use of fields F5, 
F6, and F7. 


i PR ence ee a ee ee ee ee ee 1 
[Bit [ | | 
[Number |Value| Meaning | 
ba eee ee and 
| | | | 
{0 and 1] 00 | F5 contains a dictionary | 
| | | reference | 
| } 11 | F5 contains a temporary | 
{ | | workspace offset | 
| j 01 | F5 contains symbclic | 
| { | register with address of | 
i | | item | 
| } 10 | F5 contains register with | 
| | | value of item | 
{2 | 9 | F6 does not contain index | 
| { | register | 
[ } 1 | F6 contains index register | 
{3 | 90 | Two TMPD triples are used | 
| |} 1 | Three TMPD triples are | 
| | | used, and F7 contains an | 
| | | offset | 
{4 {| 0 | Normal setting. String | 
| | | utility STRUT2 drops | 
| | | symbolic register in F5 if] 
| | | used for input 

| | 1 | String utility STRUT2 does| 
| | | not drop symbolic register | 
{5 | 90 | Normal setting 

{ { 1 | Result of an invocation of 
| | | SUBSTR or REPEAT 

| 6 | 0 | No SELL is required 

| { 1 | User of this description 

i | | must SELL dictionary 

| | | reference in F5. Set by 

| | | string utilities for 

| | | adjustable string result 

|7 | 0 | F6 does not contain a 

| | | dictionary reference 

| } 1 | F6 contains a dictionary 

| | | reference 

be Sih a eee ee eee eee eee 


2. CODE contains the data byte 
(describing type, radix, scale, mode, 
etc.) 
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3. F3 and F& contain: 

a. Precision and scale factor of 
coded arithmetic type data 

b. String length for coded 
non-adjustable strings (maximum 
length for varying strings) 

c. Picture dictionary reference for 
data with picture 


4. F5 and F6 are at present used as shown 
in Figure 12. 


5. F7 can be used by adding X'10' to the 
FLAG byte in all cases which give a 
meaningful result (see Figure 12). 


10. LIBRARY CALLING SEQUENCES 


Internal library routines are used for such 
things as data type conversion, where there 
is no explicit reference to the routine in 
the PL/I source program. The arguments are 
handed to the routines in registers. In 
pseudo-code form, assigned registers are 
used, and special markers, IPRM and IPRM' 
are used to indicate the calling sequence 
to the register allocator phase. Internal 
library calls appear in pseudo-code as: 


IPRM 

L 1, (ARGUMENT1) 

L 2, (ARGUMENT2) 

L 15, IHE---- (Routine Name) 
BALR 14,15 

IPRM’ 


The second byte of the IPRM item is used 
as a flag byte. The settings are as 


follows: 
Bit 0 Must be zero 
Bit i END, or RETURN statement not 
in BEGIN block calling 
sequence 
Bit 2 END statement calling 


sequence 


External library routines calls 
correspond to explicit references to 
functions or I/O statements in the PL/I 
source prcsgram. The arguments to the 
routines are placed in workspace, and 
register 1 is set to point to the first 
argument. For pseudo-code form the calling 
sequence is preceded by an EPRM marker and 
followed by an EPRM' marker. Thus, the 
library calling sequence appears as: 


MVC WSP (N) , (ARGUMENT1) 

EPRM 1,WSP 

L 15, IHE---- (Routine Name) 
BALR 14,15 

EPRM* 

LA 1,WSP 


The second byte of the EPRM is used as a 


flag byte. The setting is as follows: 
Bit 0 A calling sequence to a PL/I 
procedure 
11. DESCRIPTIONS OF TERNS AND 


ABBREVIATIONS USED IN TEXT DURING A 
COMPILATION 


The table in this section gives first, the 
term or abbreviation; second, the phase in 
which the term is used; and third, a brief 
description of the meaning of the term or 

abbreviation. The key to the code used is: 


R After the Read-In Phase 
PS During the Pseudo-Code Phase 


T A triple or translator input 
code byte 
Term or Used In 
Abbreviation Phase Description 
A R,T Character string 
format item 
ABS PS Indicates the start 
of absolute code 
(Appendix D7) 
ABS‘ PS Indicates the end of 
absolute code 
ADI PS Addressing 
instruction (used 
between phases RA and 
RF) 
ADR PS The two byte operand 


contains a register 
for use by final 
assembly for 
addressing branch 
destinations beyond 
4096 bytes from the 
program base 


ADV 


ALIGN 


ALLOCATE 


APRM 


ARCO 


AREA 


- ARGUMENT MARK 


ARRAY CROSS 
SECTION 


ASSIGN 


ASSIGN BYNAME 


ATTRIBUTES 


AUTOMATIC 


BACKWARDS 
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PS 


PS 


R,T,PS 


PS 


a 


R,T 


R,T 


R 


Used in 2nd file 
assignment statements 
to indicate that the 
expression has been 
calculated and that 
the following code is 
only concerned with 
assignment to the 
variable, or its dope 
vector, which is the 
subject of the second 
file statement 


Indicates that 4 byte 
alignment is required 
in the code at this 
point 


Replaces the keyword 
ALLOCATE 


Indicates the library 
calling sequence for 
VDA or controlled 
storage 


Provides space to 
allow insertion of 
argument conversion 
triple 


Replaces keyword AREA 


Marker used by phases 
GK and GP to indicate 
he start of a 
function argument 


Replaces the PL/I ‘** 
used to specify an 
array cross section 


Marker which precedes 
an assignment 
statement 


Precedes an 
asSignment statement 
with the BY NAME 
option 


Marker which precedes 
a dictionary entry 
containing the 
attributes which have 
been specified on an 
OPEN or CLOSE 
statement 


Replaces the keyword 
AUTOMATIC 


Bit string format 
item 


Replaces keyword 
BACKWARDS BEGIN 
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BASED 


BEGIN®* 


BGPE 


BGNP 


BGNP* 


BIT ATTRIBUTE 


BIT CONST 


BINARY 


BLBS 


BLBS* 


BUFFERED 


BUILTIN 


BOY 


BUY 
ASSIGNMENT 


BUYB 


PS 


PS 


PS 


PS 


PS 


BUY CHAMELEON T 
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Replaces keyword 
BASED 


Triple which 
terminates the BEGIN 
block triples 


Indicates the end of 
the complete prologue 
for a begin block 


Indicates the start 
of code for a BEGIN 
block with no 
prologue 


Indicates the end of 
code for a begin 
block with no 
prologue 


Replaces the keyword 
BIT 


Marker preceding a 
BIT string constant 


Replaces the keyword 
BINARY 


Indicates the start 
of the prologue for a 
BEGIN block 


Indicates the end of 
the prologue for a 
BEGIN block 


Replaces keyword 
BUFFERED 


Replaces the keyword 
BUILTIN 


Code byte or triple 
which indicates that 
a temporary variable 
is required 


Triple which indi- 
cates assignment to a 
temporary variable, 
and which implies 
that the workspace 
for the temporary 
variable must be 
obtained before the 
assignment 


Triple or code byte 
which indicates that 
a scalar temporary is 
required for an 
aggregate argument to 
a generic scalar 
built in function 


Marker which 


BUYS 


BY 


BY‘ 


BY NAME 


c* 


CALL 


CALL‘ 


CELL 


CHAR 


ATTRIBUTE 


CHAR CONSTANT 


CHECK 


CHSM 


CL 


CLN1 


R,T 


PS 


R,T,PS 


indicates that 
workspace is required 
for a temporary 
variable of chameleon 
data type i.e. the 
data type is taken 
from the expression 
assigned to the 
variable 


Code byte or triple 
which indicates that 
a temporary variable 
is required, and that 
initialization code 
exists between this 
triple and the BUY 
triple 


Replaces the keyword 
BY 


Triple which 
indicates the end of 
a BY expression 


Replaces the keyword 
BY NAME 


Complex decimal 
format item 


Triple which 
indicates the end of 
a C format item 


CALL statement marker 


Triple internal to 
phase IA which marks 
the end of a CALL 
statement . 


Replaces the keyword 
CELL 


Replaces the keyword 
CHARACTER 


Marker preceding a 
character string 
constant 


Replaces the keyword 
CHECK 


A special offset 
marker. Used only in 
absolute code to 
indicate that the 
offset may require 
changing 


Compiler label marker 


Compiler label number 
triple, referred to 


CLN2 T 
CLOSE R,T 
CN R,T,PS 
CNVC1,-—-4 PS 
COL R,T 
COMA T 
COMPLEX R 
COMPILER T 
ASSIGN 

COMPILER T 
FUNCTION 
COMPILER T 
FUNCTION’ 
COMPILER T 


FUNCTION CALL 


COMPILER T 
FUNCTION CALL‘ 


COMPILER T 
FUNCTION COMMA 


once only in the 
current statement 


Compiler label number 
triple, referred to 
at any point 


Replaces the keyword 
CLOSE 


Compiler statement 
number. Can precede 
compiler inserted 
statements 


Convert compiler 
functions 

=Drop all registers 
2=Drop target 
register 

3=Drop source 
register 

4=Do not drop 
register 


Replaces the keyword 
COLUMN 


Triple indicating an 
individual subscript 
in a subscript list 


Replaces the keyword 
COMPLEX 


Code byte or triple 
indicating assignment 


Code byte or triple 
used to indicate the 
Start of a compiler 
function cail 
argument list 


Triple indicating the 
end of a compiler 
function argument 
list 


Code byte or triple 
used to indicate the 
start of a compiler 
function call 
argument list 


Triple indicating the 
end of a compiler 
function call 
aroqument list 


Triple used to indi- 
cate the argument of 
compiler function, or 
Pseudo-Variable 


COMPILER T 
PSEUDO- VARIABLE * 
COMPILER 7 
PSEUDO- VARIABLE 
COMR T 
CONDITION R 
CONTROLLED R 
CONTROL R,T 
VARIABLE 

CONVERS ION R 
COPY R,T 
CONTROL T 
VARIABLE 

DATA R,T 
DATA‘ 2 
DATA LIST DO R 
DCF2 PS 
DECIMAL R 
DECLARE R 
DEFINED R 
DEFINED T 
SUBSCRIPT 


Triple indicating the 
end of a compiler 
pseudo-variable 
argument list 


Code byte or triple 
used to indicate the 
Start of a compiler 
pseudo-variable 
argument list 


Triple indicating an 
individual subscript 
held in a register 


Replaces the keyword 
CONDITION 


Replaces the keyword 
CONTROLLED 


Marker which indi- 
cates the control 
variable of a DO loop 


Replaces the keyword 
CONVERSION 


Replaces the keyword 
COPY 


Triple which indi- 
cates the end of a 
control variable 
expression 


Replaces the keyword 
DATA 


Triple indicating the 
end of a data 
Girected I/O list 


Replaces the keyword 
DO in an iterative 
clause in a data list 


Causes output of 
"ERROR STOP' and the 
four bytes following 
in the pseudo-code 
item 


Replaces the keyword 
DECIMAL 


Replaces the keyword 
DECLARE 


Replaces the keyword 
DEFINED 


Marker which precedes 
the parenthesized 
iSUB subscript list 
of a defined array 
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DELAY 


DELETE 


DICTIONARY 
REFERENCE 


DIRECT 


DISPLAY 


DO 


DO EQUALS 


DROB 


DROP 


DROP 


DRPL 


EDIT 


EDIT* 


EIO 
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PS 


PS 


PS 


R,T 


Replaces the keyword 
DELAY 


Replaces the keyword 
DELETE 


Marker indicating 
that the following 
two bytes contain a 
symbolic dictionary 
reference 


Replaces the keyword 
DIRECT 


Replaces the keyword 
DISPLAY 


Replaces the keyword 
DO, ina 
non-iterative DO 
group 


Marker which replaces 
the PL/I‘=' in the 
iterative DO 
statement (DO I= ) 


Indicates to the 
register allocation 
phases that a base 
register used for 
addressing a 
controlled variable 
should be dropped 


Triple used in 
optimization 
indicating the drop 
of an index register 


Indicates that a 
symbolic or assigned 
register in the 
operand field of the 
instruction is no 
longer required 


Indicates the end of 
the use of a list of 
symbolic registers 
which have appeared 
in an USSL item 


Floating decimal 
format item 


Replaces the keyword 
EDIT 


Triple indicating the 
end of an edit 
directed I/O list 


Code byte or triple 
which indicates the 
end of an I/O 
statement 


ELSE 


END 


END BLOCK 


END DO 


ENDFILE 


END ITDO 


END LIST MARK 


END PROG 


END PROGRAM2 


ENTRY 


EPRM 


' EPRM‘ 


EQU 


EQU* 


R,T,PS 


T,PS 


PS 


PS 


PS 


PS 


Replaces the keyword 
ELSE 


Replaces the END 
keyword at the end of 
a BEGIN Or PROCEDURE 
block 


Indicates the end of 
a text block 


Replaces the END 
keyword at the end of 
a non-iterative DO 
group 


Replaces the keyword 
ENDFILE 


Replaces the END 
keyword at the end of 
an iterative DO loop 


Marker used by phases 
GK and GP to indicate 
the end of a function 
argument list 


Marks the end of 
program 


Triple which marks 
the end of the second 
file text i.e. 
prologue 
initialization text, 
which is placed after 
the source program 
text 


Replaces the keyword 
ENTRY 


Indicates the start 
of an external 
library calling 
sequence. (Appendix 
p10) 


Indicates the end of 
an external library 
calling sequence 


Indicates that the 
two byte operand 
field contains a 
label. The label is 
considered to be 
attached to the 
following pseudo-code 
item 


As for EQU, but 
indicates that 
control may enter 
from a different 
statement. 


ERROR 


ERROR 


ERROR 


EVENT 
EXCLUSIVE 
EXIT 


EXTERNAL 


Ff? 


F COMMA 


FILE 
FILE 
FINISH 
FIXED 


FIX BINARY 
IMAGINARY 


FIX BINARY 
REAL 


FIX DECIMAL 
IMAGINARY 


FIX DECIMAL 
REAL 


PS 


R,T 


R,T 


Replaces the keyword 
ERROR 


Code byte or triple 
which marks the 
position of an 
erroneous source 
statement which has 
been deleted 


Indicates the 
presence of a source 
program error 


Replaces the keyword 
EVENT 


Replaces keyword 
EXCLUSIVE 


Replaces the keyword 
EXIT 


Replaces the keyword 
EXTERNAL 


Fixed decimal format 
item 


Triple which 
indicates the end of 
an F format item 


Triple used to 
indicate the 
arguments of a 
function or pseudo 
variable 


Replaces the keyword 
FILE 


Triple indicating the 
end of a file list 


Replaces keyword 
FINISH 


Replaces the keyword 
FIXED 


Marker which precedes 
a fixed binary 
imaginary constant 


Marker which precedes 
a fixed binary real 
constant 


Marker which precedes 
a fixed decimal 
imaginary constant 


Marker which precedes 
a fixed decimal real 
constant. 


FIXED 
OVERFLOW 
FLOAT 


FLOAT BINARY 
IMAGINARY 


FLOAT BINARY 
REAL 


FLOAT DECIMAL 
IMAGINARY 


FLOAT DECIMAL 
REAL 


FORMAT 


FORMAT‘ 


FORMAT LIST 


FORMAT LIST‘ 


FREE 


FROM 


FUNCTION 


FUNCTION 


GENERIC 


GET 


GOOB 


GOLN 


GOTO 
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R,T 


Replaces keywords 
FIXED OVERFLOW 


Replaces the keyword 
FLOAT 


Marker which precedes 
a float binary 
imaginary constant 


Marker which precedes 
a float binary real 
constant 


Marker which precedes 
a float decimal 
imaginary constant 


Marker which precedes 
a float decimal real 
constant 


Replaces the keyword 
FORMAT 


Triple which marks 
the end of a remote 
format statement 


Precedes a format 
list 


Triple indicating the 
end of a format list 


Replaces the keyword 
FREE 


Replaces the keyword 
FROM 


Code pyte or triple 
indicating the start 
of a function 
argument list 


Marker which precedes 
the parenthesized 
argument list (if 
present) of an entry 
name in a function 
reference or CALL 
statement 


Replaces the keyword 
GENERIC 


Replaces the keyword 
GET 


GOTO out of block 
statement marker 


Indicates a branch to 
a label number 


GOTO in block 
statement marker 
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IDENT R,T 


IF R,T 
IF’ T 
IGN 2..8 

IGNORE R,T 
IGNORE PS 
In R/T 
INITIAL R 


INITIAL LABEL R 


INITVAR R 
LAPUT R 

INST PC 
INTEGER R 
INTERNAL R 
INTO R,T 
IPR™ PS 
ITDO R,T,PS 


Quy 


Replaces the keyword 
IDENT 


Replaces the keyword 
IF 


Triple which 
terminates an IF 
expression 


Ignore markers used 
by Final Assembly 
when code has been 
Made redundant. The 
final digit indicates 
length to be ignored. 


Replaces the keyword 
IGNORE 


Pseudo-code item 
which indicates that 
the number of bytes 
appearing in the 
length count must be 
ignored 


Replaces the keyword 
IN 


Replaces the keyword 
INITIAL 


Marker which precedes 
elements of arrays of 
labelvariables which 
are initialized by 
being attached to 
Statements 


Replaces the keyword 
INITIAL(iteration 
factors) 


Replaces keyword 
INPUT 


Defines a store 
generated by register 
allocator which may 
be deleted by phase 
TF if unused 


Marker which precedes 
an internal binary 
integer constant 


Replaces the keyword. 
INTERNAL 


Replaces the keyword 
INTO 


Indicates the end of 
an internal library 
calling sequence 


Replaces the keyword 


ITDO’ 


JMP 


KEY 


KEYED 


KEYFROM 


KEYTO 


LABEL 


LEFT 


LIKE 


LINE 


LINESIZE 


LIST 


LIstT' 


LIST MARK 


LITERAL 
CONSTANT 


LOCATE 


MAIN 


MDRP 


DO in an iterative DO 
loop 


Triple which 
terminates an 
iterative DO 
expression 


Triple indicate the 
presence of 
pseudo-code. The 
number of bytes of 
pseudo-code is 
specified in the 
first operand 


Replaces the keyword 
KEY 


Replaces keyword 
KEYED 


Replaces the keyword 
KEYFROM 


Replaces the keyword 
KEYTO 


Replaces the keyword 
LABEL 


Triple indicating a 
temporary result for 
a pseudo-variable 


Replaces the keyword 
LIKE 


Replaces the keyword 
LINE 


Replaces the keyword 
LINESIZE 


Replaces the keyword 
LIST 


Triple indicating the 
end of a list 
directed I/O list 


Marker used by Phases 
GK and GP to indicate 
the start of function 
argument list 


Indicates that the 
following two bytes 
contain a fixed 
binary constant 


Replaces the keyword 
LOCATE 


Replaces keyword MAIN 


Defines a register 
which will be 


MULTI PLE 
ASSIGN 


MVCL 


NAME 


NEW PAGE 


NOCdECK 


NO SNAP 


NOSNAP* 


NULL 


PC 


R,T 


NULL-FUNCTION T 


ON 


OPTIiCHS 


ON RECORD 


OSM1 


OSM2 


R,T 


PS 


multiply dropped. 
Phase RA no-ops all 
DROP's for this 
register except the 
last 


Marker indicating 
multiple assignment 
(Replaces PL/I‘,") 


Defines a character 
move greater than 256 
bytes. This is 
expanded by phase OF 


Replaces the keyword 
NAME in the context 
of ON NAME 


Replaces the keyword 
NEW PAGE 


Replaces the keyword 
NOCHECK 


Replaces the keyword 
NOSWNAP 


Triple which 
indicates the end of 
a NOSNAP list 


Null statement marker 


Enables TMPD's to be 
passed in text by 
phases LB and LG 
before the evaluation 
phase LS 


Replaces the keyword 
OFFSET 


Replaces the keyword 
OPEN 


Triple indicating 
offset used in 
optinization of BO 
loops 


Renlaces the keyword 
Ou 


nerlaces tne keyword 
OPTIONS 


Repiaces the keyword 
RECORG in the context 
ON RECORD 


Indicates that the 
twe byte operand 
Field contains an 
index register 


Indicates that the 
two byte operand 


OSM3 


OUTPUT 


OVERFLOW 


PAGE 


PAGESIZE 


PASS 


PCBS 


Pcc 


PFMT 


PICTURE 


PINS 


PLBS 


PLBS* 


POINTER 


PRECISION1 


PS 


AR,T 


PS 


PS 


PS 


PS 


PS 


PS 


R 


field contains a 
leteral offset 


Indicates the 
presence of a literal 
offset and an index 
register 


Replaces keyword 
OUTPUT 


Replaces keyword 
OVERFLOW 


Picture format item 


Triple which 
indicates the end of 
a P format item 


Picture format item 


Replaces the keyword 
PAGESIZE 


POINTER Assignment 


Indicates the end of 
the complete prologue 
for a procedure block 


Follows a PROC or 
BEGIN marker. Used 
to carry the prefix 
change pyte for the 
block. 


PICTURE format 


Replaces the keyword 
PICTURE 


Indicates the 
prologue insertion 
point 


Indicates the start 
of the prologue for a 
procedure block which 
is common to all 
entry points 


Indicates the end of 
the prologue of a 
procedure block which 
is common to all 
entry points 


Replaces the keyword 
POINTER 


Indicates a precision 
which has been 
written in the source 
program as ‘'(10)', 
which may be either 
fixed or float 
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PRECISION2 


PRINT 
PRIORITY 
PSEUDO- 


VARIABLE 


PSEUDO- 
VARIABLE 


PSEUDO- 
VARIABLE ' 


PSLD 


PROC 


PROC’ 


PTCH 


PUT 


READ 
REAL 


RECORD 


H46 


PS 


R,T PS 


T.PS 


Indicates a precision 
which has been _ 
written in the source 
program as '(5,2)' 
which implies fixed 


Replaces keyword 
PRINT 


Replaces the keyword 
PRIORITY 


Marker which precedes 
the parenthesized 
argument list to a 
pseudo-variable 


Code byte or triple 
indicating the start 
of a pseudo-variable 
aroument list 


Triple indicating the 
end of a 
pseudo-variable 
argument list 


Indicates a 
pseudo-code 
instruction for use 
by the final assembly 
listing phase 


Replaces the keyword 
PROCEDURE 


Triple which 
terminates the 
procedure block 
triples 


Patch triple. Used 
by optimization phase 
to overwrite a triple 
in text at a point 
where code is to be 
inserted. The code 
to be inserted and 
the overwritten 
triple are held ina 
table in text blocks 


Replaces the keyword 
PUT 

Remote format 
statement marker 


Replaces the keyword 
READ 


Replaces the keyword 
REAL 


Replaces the keyword 
RECORD 


RECURSIVE 


REENTRANT 
REPLY 
RETURN 
REVERT 
REWRITE 


RPL 


RPL' 


RWA 


SECONDARY 
SECOND LEVEL 
MARKER 


SELL 


SET 
SETS 
SKQUENTIAL 
SIGNAL 


SIZE 


PS 


T,PS 


Replaces the keyword 
RECURSIVE 


Replaces the keyword 
REENTRANT 


Replaces the keyword 
REPLY 


Replaces statement 
marker 


Replaces the keyword 
REVERT 


Replaces the keyword 
REWRITE 


Code byte or triple 
indicating the start 
of a format list 
replication factor 
expression 


Triple indicating the 
end of a format list 
replication factor 
expression 


Indication of an 
addressing vector for 
use by the register 
allocator when the 
number of symbolic 
registers in use 
exceeds the amount of 
work space which has 
been allocated 


Replaces keyword 
SECONDARY 


A code byte which 
immediately precedes 
all code bytes 
appearing in the 
second level table 


Code byte or triple 
which indicates that 
a temporary variable 
is no longer required 


Replaces the keyword 
SET 


Replaces the keyword 
SETS 


Replaces the keyword 
SEQUENTIAL 


Replaces the keyword 
SIGNAL 


Replaces the keyword 
SIZE 


SKIP 


SL 


SN 


SN2 


SN3 


SNAP*. 


STATIC 


STERLING 


DECIMAL REAL 


STOP 


STREAM 


STRING 


STRING * 


STRINGRANGE 


SUB 


SUBSCRIPT 


SUBSCRIPT* 


R,T 
R,T,PS 
R,T,PS 


R,T,PS 


PS 


R 


R,T 


R,T 


Replaces the keyword 
SKIP 


Statement label 
marker. Precedes all 
labelled statements | 


Statement number 
marker. Precedes all 
unlabelled statements 


Marker which precedes 
a second file , 
statement (See 
Appendix D.8) 


Indicates the start 
of a second file 
statement which is 
concerned with 
initializing array, 
or structure, or 
string dope vectors. 
Similar to SN2 
(Appendix D.8) except 
that there is no 
associated entry 


Triple which 
indicates the end of 
a snap list 


Replaces the keyword 


STATIC 


Marker which precedes 
a sterlino decimal 
constant 


Replaces the keyword 
STOP 


Replaces keyword 
STREAM 


Replaces the keyword 
STRING 


Triple indicating the 
end of a string list 
used with list 
directed I/0 


Replaces the keyword 
STRINGRANGE 


Replaces the keyword 
SUB used in iSUB 
DEFINING marker 
preceding a BIT 


Marker which precedes 
the parenthesized 

subscript list of an 

array 


Triple indicating the 


SUBSCRIPT=- 
RANGE 


SSB‘ 


SSUB 


SYSTEM 


SYSTEM‘ 


TASK 


THEN 


TITLE 


TMPD 


TO 


To* 


TRANSMIT 


UNBUFFERED 


UNDEFINEDFILE R 


UNDERFLOW 


UNLOCK 


UPDATE 


USES 


USNG 
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R 


R,T 


PS 


end of a subscript 
list 


Replaces keyword SUB- 
SCRI PTRANGE 


Supersubs prime 
triple. Similar to 
SUBS'. Used by 
Optimization phases 
in conjunction with 
SSUB 


Supersubs triple. 
Similar to SUBS. 
Used by Optimization 
phases 


Replaces the keyword 
SYSTEM 


Triple which 
indicates the end of 
a system list 


Replaces the keyword 
TASK 


Replaces the keyword 
THEN 


Replaces the keyword 
TITLE 


Triple indicating a 
temporary expression 
result. 


Marker replacing TO 
in the iterative DO 
statement 


Triple which 
indicates the end of 
a TO expression 


Replaces the keyword 
TRANSMIT 


Replaces the keyword 
UNBUFFERED 


Replaces the keyword 
UNDEFINEDFILE 


Replaces keyword 
UNDERFLOW 


Replaces the keyword 
UNLOCK 


Replaces keyword 
UPDATE 


Replaces the keyword 
USES 


Indicates the 
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USSL 


VARYING 


WHILE 
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PS 


R,T 


presence of an 
assigned register 


Indicates a list of 
symbolic registers 
which need not be 
saved on branch and 
branch and link 
instructions 


Replaces the keyword 
VARYING 


Replaces the keyword 
WHILE 


WHILE’ T 
WRITE R,T 
xX R,T 


ZERODIVIDE R 


Triple which 
indicates the end of 
a WHILE expression 


Replaces the keyword 
WRITE 


Spacing format item 


Replaces the keyword 
ZERODIVIDE 


The (F) Compiler requires main storage for 
the following purposes : 


Compiler processing phases 
Print buffers 

Compiler control routines 
Dictionary area 

Text area 

Input/Output buffers 
Input/Output routines (BSAM) 

The main storage required by each phase 
of the compiler need be contiguous only for 
each control section. 

Curing the read-in phases a minimum of 
two dictionary blocks and two text blocks 
is available in storage simultaneously. 

During the optimization logical phase, a 
minimum of three dictionary and five text 
blocks are available in storage 
simultaneously. 

During the rest of the compilation four 


dictionary blocks and four text blocks are 
available in storage simultaneously. 
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The dictionary and text block size is 
chosen according to the amount of main 
Storage available to the compiler. The 
SIZE option, interpreted at invocation 
time, provides the value used to determine 
the block size. The space needed for large 
I/O buffers is subtracted from SIZE and the 
space remaining is used when determining 
text and dictionary block size, as detailed 
in the publication IBM System/360 PL/I (F) 
Programmer's Guide. A table contained in 
Phase AB is searched, using the SIZE option 
as an argument. When the correct entry is 
found, the block size is extracted. 


The first table shows the relationship 
between the compiler requirements and the 
text and dictionary block sizes. The 
second table details the storage allocation 
in each environment. 


| SSS RETEOS To, ee ee ee a] 
| Environment | Dictionary/Text | Compiler | 
| | Block Size {Requirements | 
}-----------}----—-----+---- f-----—-=--=- 
| A | 1K | 44K - 56K | 
| B | 2K | 56K - 72K | 
| c | WK | 72K - 132K | 
| D | 8K |. 132K - 168K | 
| E | 16K | 168K | 
L 
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Compiler Requirements and Dictionary/Text Block Relationship 


Cg en te eee ea eee ie Tee og ee A ee Oe ee Paap RET te re ee ee eee asses See s= 
! | DURING READ-IN PHASE | AFTER READ-IN PHASE | 
[aoe eee 4----------~.~..--.~--.---.---. 
| Storage Allocation | ENVIRONMENT | ENVIRONMENT 7 
| aaineneel Geieieien Gebeieiane: Gueebaieien ileteieteten Geteeetes tetetetaien neeteteten Gateteneten Generate 
| 1 A |B jc {| DtE {| A tyBYytct vdteE | 
ban rn rn ttt nt nf nn ff nn ff -- 
OS Dynamic Storage | 7 | ! ! | | | | | | 
| | | | | | 
| TIOT | 228| 228{ 228{ 228| 228| 228, 228] 228| 228] 228] 
| SPIE | 32| 32] 32| 32] 32| 32 | 32| 32| 32| 32| 
| LCAD | 40] 4O0| 40| 40} 40| 4&O| 40| 40| 4O| 40| 
I | | | | | | | | | | | 
! OS Temporary Storage | | ! | | | | | 
| | | | | 
| End of Volume | 800{ 800] 800] 800] 800} 800{ 800] 800] 800] 800] 
| Data Management 1 4894] 4894] 489K] 4894] 4894] 4894] 4894] 4894] 489K] 4E94{ 
| Compiler Control [12266|12266|12266|12266| 12266|12266|(12266|12266| 12266| 12266| 
| Phase Area {16384 |16384/16384|16384| 16384)12288|12288]12288| 12288] 12288] 
| Text Area | 2048] 8192/16384|32768| 65536] 4096| 8192|16384| 32768| 65536| 
| Dictionary Area | 2048] 8192|16384|32768| 65536| 4096] 8192/16384| 32768| 65536| 
| Scratch Storage | 4096] 4096] 4O096[ 4096] 4096] 4096] 4096] 4096| 4096] 4096} 
| 170 Buffers { 1538] 1538| 1538] 1538] 1538] 1538] 1538] 1538] 1538] 1538| 
[Se ee 
| TOTALS 144374 |56662]73038105814 [171340[ 44374 | 52566] 68950] 101718 | 167254| 
boc er eee ee eee ee Se a eed 
Initially, four text and four dictionary blocks, more main storage is allocated as 
blocks are allocated to the compiler (two blocks. This process continues until the 
each are allocated when only 44K bytes of spill point is reached (i.e., until all the 
storage are available to the compiler. main storage available to the compiler has 
This is then expanded to four of each at been used). If still more main storage is 
the end of the read-in phase). If the text required, the spill file (SYSUT1) is 
and/or dictionary expands to fill these opened, and blocks are written out. 
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The communications region is an area 
specified by the control routines (see 
Appendix L), and used to communicate 
necessary information between the various 
phases of the compiler. The communications 
region is resident in the first dictionary 
block throughout the compilation. 


Note: The use of the communications region 
during compile-time processing is 
described in Appendix J. 


The tables below give the following 
information for each location of the 


APPENDIX F: COMMUNICATIONS REGION 


communications region: name of location; 
offset (i.e., relative address); use (i.e., 
stages of compilation during which the 
location is in use); and a description of 
the contents. Certain locations are used 
in one capacity during part of the 
compilation, and then re-used in a 
different capacity during another part of 
the compilation. In these cases, one 
location will have two table entries: 
details of alternative usage appear in the 
columns headed Nameg, Usea, etc. 
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Table 1. Communications Region 


(Se Te Sa ee eS aay 
| Name |Offset (Dec.) | Use | Description | 
}-----—-- ——--—--—---}-—------—--- —------------------------------------- 
| SAVEO | 0 | ALL PHASES | Register save area 
| SAVE1 |SAVE0+4 | ALL PHASES | Register save area | 
! SAVE2 oe ETC. ALL PHASES | Register save area | 
. e e | e | 
ee |. | : { ‘ | 
| SAVE15 |SAVE0+60 {| ALL PHASES | Register save area 
| ZTV | 64 | ALL PHASES | Control phase base | 
| ZTRAN1 | 68 | ALL PHASES | External to internal translate table | 
| ZTRAN2 | ZTRAN1+4 | ALL PHASES | Internal to external translate table | 
| ZNXTD | 76 | ALL PHASES | Next available dictionary location { 
| ZERRD | 80 | ALL PHASES | | 
| ZERRS |ZERRD+t4 | ALL PHASES | First locations of error chains | 
| ZERRW | ZERRD+8 {| ALL PHASES | | 
| ZERRC |ZERRD+12 | ALL PHASES | | 
| ZDNXT | ZERRD+16 | ALL PHASES | | 
| ZSNXT |ZDNXT+4 { ALL PHASES | Current ends of error chains | 
| ZWNXT | ZDNXT+8 | ALL PHASES | | 
| ZCNXT |ZDNXT+12 | ALL PHASES | | 
ZMYNAM 112 ALL PHASES | Name of last phase entered | 
i | 
| DIcTP | 116 | ALL PHASES | ; | 
| ZCNCHR | 118 | ALL-° PHASES | Source column containing control | 
| | | | character | 
| ZPROCH | 120 | ALL PHASES | Chain of created procedures | 
{| ZSTAT | 124 | ALL PHASES | Current statement number | 
| PAR1 { 128 {| ALL PHASES | Parameter word 1 | 
PAR2 |PAR1+4 ETC | ALL PHASES | Parameter word 2 | 
= ie . | : | 
bo ; | 
| PARS8 | PAR1¢28 { ALL PHASES | Parameter word 8 | 
| CORLFr | 160 | ALL PHASES | Amount of core left for compilation | 
| LKNAME | 164 | PHASE VE | Member name of module produced by | 
| | I | compilation | 
| ZOBSAD | 172 | ALL PHASES | Address of overflow block | 
| TERMSW | 176 { ALL PHASES | Compilation terminating switch | 
| | | { | 
| OFDNAM | 178 | ALL PHASES | | 
| SPLNAM | 180 | ALL PHASES | Name of phase in control when | 
| | | |.spill file is opened | 
| ZOBNUM | 182 {| ALL PHASES | Overflow block number | 
| SCNOP | 184 | ALL PHASES | Phase directory scan switch | 
| SCCNF | 185 | ALL PHASES | On if in second half of compiler | 
| ZDROLF | 186 | ALL PHASES | Overlay switch | 
| AREA | 187 ] ALL PHASES | Code word for dummy routines | 
| I { | (phase AD) | 
| ZM91 | 188 | ALL PHASES | (used for Model 91 systems) | 
| PERRSW | 189 | ALL PHASES | Print error switch | 
| BERSW | 190 { ALL PHASES | *process error byte | 
| IOERSW | 191 | ALL PHASES | I/O error switch | 
| ZPAGE | 192 | ALL PHASES | Number of lines in page | 
| ZLINE | 194 | ALL PHASES | Number of characters in a line | 
| ZOPT | 196 | ALL PHASES | Code word of loading of optimizing | 
| | | | phases . |. 
| PARMLEN | 197 | ALL PHASES | Length of options field in * - process| 
| {| card 
| MAXFON |. 198 | ALL PHASES | Number of offset slots in a ere 
| | | | block 
| ZDICTSP | 200 | ALL PHASES | Useful dictionary block size | 
etc a came ee a ed gs ta cas og as me em meg teen a ae | 


Note: If a program interrupt occurs both 


interrupt PSW. 
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LKNAME and CORLFT are overwritten by the 


Table 1. Communications Region (cont'd) 


SS ee ee ee et ee ee eee eae 
| Name jOffset (Dec.) | Use | Description | 
a a a ef 
| ZNXTOF | 204 | ALL PHASES | Offset of next dictionary entry 

| FONOF | 208 {| ALL PHASES | Offset of offset slots in dictionary | 
{ { | | block | 
| FSTDRF | 212 | ALL PHASES | Dictionary reference of last diction- | 
| | | | | ary entry | 
| ERCODE | 224 | ALL PHASES | Error message codes | 
| MCSIZE | 228 | ALL PHASES | M/CSIZE this run | 
| CCCODE | 232 | ALL PHASES |.Control card requests | 
] | | ae | (see table 4% below). | 
| HDR | 236 | ALL PHASES | Address of phase directory | 
| TLR | 240 | ALL . PHASES | Timer last read | 
| TRT | 244 | ALL PHASES | Total run time | 
| ARINT | 248 | ALL PHASES | Arithmetic interrupt | 
| BR2 | 252 | ALL PHASES |. Second base for control phase | 
| STARTX | 256 |} ALL PHASES | Start of text | 
| DIcTsz | 260 | ALL PHASES | Dictionary block size | 
| TXTSZ | 264 {| ALL PHASES | Space available in text block | 
| RDSIZE | 268 | ALL PHASES | SIZE of read area | 
{ INCOD | 272 | ALL PHASES | Interrupt code { 
| ARMASK | 273 {| ALL PHASES | Arithmetic error mask | 
{| LOCK | 274 | ALL PHASES | Dictionary lock slot | 
| ZNXTLC | 276 | ALL .PHASES | End of current text | 
{| ZSHIFT | 280 | ALL #§$PHASES | Number of bits in dictionary reference| 
| | | | offset | 
| ZMASK | 284 | ALL PHASES | Mask to remove block numbers | 
| ZMASK1 |ZMASK + 2 | ALL PHASES | Mask to remove offset | 
{| ZSOR | 288 | ALL PHASES | Input record source | 
| ZMAG | 290 | ALL PHASES -| Input record margin | 
| CCCODEE | 292. | ALL PHASES | Control card requests 1 
| ZCOMM | ° 304 | ALL PHASES | | 
t aS 
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Table 2. Communications Region 


| eaten Seeteetenneaneateetans 


| | Dec. | Use | | | Usea | 1 
| Name | Offset }-~----—----- , iateeeeteanetereane -{| Description |Nameg }----- —y--~---| Description, | 
| | {| Start End | | |Start | End | | 
~-~---}--------}----—--—- }----------}-------------- $------ $--—--- $------ }----------~--- { 
| ZCALLC | ZCOMM+ O]|Read in |BCD to |Start of CALL | | | | | 
| | |Dict. Ref.| chain | | | { | 
| ZLABTB | + 4|Read in {Initial |Start of label| | | | | 
fe el | ] | chain | | | | | 
| ZATTID| +8| | {Pointer to [| ZPCOP | | | | 
| | | | | attribute | | | | | 

| | | |tidy-up area | | | | | 
| ZALLCH | +12|Read in [ALLOCATE +|Start of | | | | | 
| | | {Attribute |ALLOCATE chain| | | | | 
| ZFLAG 1 | +16|Read in |Dictionary|Flag bytes, | [ | | | 
| ZFLAG 2 | +17| | |mainly used | | | | | 
| ZF LAG 3 | +18 | | |for optional | | | | | 
| ZELAGS | +19] | | phase | | | | | 
| ZFLAGS | +20| { {marking (see | ZSYSOT|Pseudo|Pseudo|Dict. Ref. | 
| | | | {table 3 below) | |code |code |SYSOUT | 
| ZFLAG6 | +21| FU {QU | Unaligned | | | | | 
| | | | | (see Table 3) | | | | | 
| UNUSED | +21| | | | | | I | 
| TO| | | | | | | | 
| | +23] | | | | | | | 
| ZSCRCH | +24|PD |PL {Address of | | | | | 
| | | | [scratch core | | | | | 
| | | | |kept across | | | | | 
| | | | phases | | | | 
[UNUSED | +#25| | | | | | | | 
| | TO| | | | | ] | 
| | +27, i | | | | | l 
| ZHASH | +28|Dictionary|Dictionary|Start of hash |ZINCL |PC. {End {INCLUDE card | 
| | | l [table | | | | pointer | 
| | +#32|Not used {Not used | | ZEQTA3|Final |Assy. |Assigned | 
| | | | { | joffset table | 
| ZFATTB | +36 |Dictionary |Declare {Start of fact-|ZLCONS|Strge JALLoc |Last constant | 
| | |pass 2 jored attribute|ZEOCS Jin STATIC. | 
| i | { | {End of STATIC | 
| ZCDIMC | +40| Dictionary | Pre- |Start constant| ZSMREG|Trans-~|Pseudo|Current sym _ | 
| | {translator | dimension | jlator |code |bolic register| 
| Z2FILE | +44 (Dictionary |End [Start of i | | 
| | | |second file | | | | | 
| ZDLFST | +48 | Dictionary |Storage | Defined | ZFSTEX|Strge |End |First external | 
| |allocator |storage area | _ [alloc | {item | 
| ZDCBLD | +52| Dictionary |Dictionary | Dictionary | ZPRSIZ|Final |Assy. [Size of com | 
| | build area | | |piled program | 
| ZMPSTK | +56| Dictionary |Translator|Program map | ZSICSZ|Final |Assy. |STATIC | 
| | {stack | | | INTERNAL size | 
{ZUPIC | +60| Dictionary |Picture | Start of |ZSTALC|Pinal |Assy. |Storage loc- | 
| | | {processor |picture chain | | | Jation counter | 
| ZPROC1 | +64| Dictionary |End |Start of entry] | | | | 
| | | [type 1 chain | | | | | 
| ZSTACH | +68| Dictionary |End {Start of STAT-| ] | | | 
| { | {Ic chain (6) | { | | | 
| ZVDIMC | +74| Dictionary |Translator|Start of vari-| | | | | 
| | | | Jable dimension| | | | | 
| | | | | chain | | | | 
| ZCONCH | +78|Dictionary|ALLOCATE |Start of con- | | | | | 
| | . |stants chain | | | | ; | 
| ZDEFCH | +80| Dictionary |Dictionary|Chain of | ZCITEM| Pre | End {Chain of CON- | 
| | | |defined items | [trans. | | TROLLED items | 
| ZLIKCH | +82| Dictionary |Dictionary|Chain of LIKE | ZEQMAX|Pseudo|End |Max. label | 
| | { | | items | |code | | number | 
ba ence cence ae ee ne corer eee ete dh ce en eee ee ee eS Cn Bee eS Se ee es Se | 
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Table 2. Communications Region (cont'd) 











oS -- a aha SS Sg ee eet 
| | Dec. | Use | | | Usea | 

| Name | Offset }---~-—----——y;----—--—--] Description |Nameg }--—----y---—--|Description, | 
| | | Start | End H | |Start | End | 

------ —-}-——-—--—}----—--—-- + -—--—-------—-}-—-----—-- +- —------—----—- { 
| ZPOLCH | +84|Dictionary|Dictionary| Chain of POOL | ZOSMRG|Pseudo|Pseudo|End of | 
] | | | items | |code |code joptimization | 
| | | | | | |symbolic reg- | 
| | —— —— | | | | isters | 
| ZDCOM1 | ZCOMM+ 86 | Dictionary | Dictionary| Latest | ZCOBOL| GB | JI _ |Head of COBOL | 
{ | | | |dict. ref. | | | | structure | 
| [. ae | | | [chain | 
| ZDCOM2 | +90|Dictionary|Dictionary|Flags for dic-| | | | | 
| | | | [tionary build | | | | | 
| | | | | interface | 1 | | \ 
| | | | | (8 bytes) | | | | | 
{|ZDSA | ZCOMM+94| PA | UD |Head of STATIC| | | | | 
| | | | {DSA chain | | | | | 
| ZCPOFF | ZCOMM| PD | UA {Offset of | | | | | 
| | +100] | | first | | | | | 
\ | | | {constants pool| | | | | 
| | | | jwithin static | | | [ | 
| | | | | internal. | | | | 
|MACRON| ZCOMM| BW {| TP {Macro reqd | | | | | 
| | +336| | | count | | | | | 
| | | | | Chalfword) | | | | | 
| SOURCN | ZCOMM | cI | TP {Source reqd | | | | | 
| | +338 | | count | | | | | 
| | | | | Chalfword) | 1 | | | 
| STMNTN | ZCOMM| cI | TP {Source stmt | | | | | 
| | +340 | | count | | | | | 
| | | | | Chal fword) | | | | | 
{ INSTRN | ZCOMM | TJ | TP jObject instn | | | | | 
| | +342| | | count | | | | | 
| | | | | Chalfword) | | | | | 
| BYTESN| ZCOMM | TO | TP {Object byte | | { iz | 
| | +344 | | count | | | | | 
| | { | : | (fullword) | i | | | 
{|ZSAV_ | ZCOMM| Resident |Resident |Register save | | | | | 
| | +#360|Control {Control | area | | | | 
| | | | { (18 fullwords) | | | | | 
bese beter ek ona oe ae | SEEN iain aataaecaeaiaidh aa daemneilced aaa aps ail aicas plans J 





NOTE: Bytes ZCOMM+60 to ZCOMM+332 are used internally within the Read-in phase and cannot 
be assumed to be zero at exit from that phase. 
Bytes ZCOMM4#336 to ZCOMM+344 are not available for re-use 
Bytes ZCOMM+104 to ZCOMM+131 are used by the generic phase IM. They are cleared 
before exit from the phase. 
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Table 3. Communications Region. Bit Usage in ZFLAGS 


| BYTE | OFFSET | BIT | BIT NAME 
| NAME | | (HEX) | 
acne ae ne oo hee ee ee aoe fF -- 

| ZFLAG1l | ZCOMM#16 | 80 | ZDEFFL 

{ | | 40 | ZAWAFL 

i | 1 20 | ZSECFL 

| | | 10 | ZDIMFL 

\ | 1 08 | ZCHKFL 

i | | O48 | ZONFL 

| | | 02 | #£=ZSTRFL 

{ 1 01 ZDECFL 

| | 

| ZFLAG2 | 417 { 80 | ZLIKFL 

{ | | 40 {| ZINTST 

| { | 20 {| ZOPCFL 

| i | 10 | ZGTPFL 

{ | |} 08 {| ZGOTFL 

! | | O8 | ZTEPFL 

| | } 02 | ZPICFL 

| | { O01 | ZISBFL 

{ { 

ZFLAG3 | #18 | 80 | ZCONTG 

| | | 40 | ZSETFL 

| { | 20 {| ZOSSFL 

| | | 10 |{ ZARGFL 

r | | 08 | ZINLFL 

| i {| O04 | ZDIOFL 

| | | 02 | ZRECIO 

i 1 01 | ZINTAC 

| 

ZFLAG4 +19{ 80 | ZFREE 

| \ | 40 | STM256 

| | {| 20 | FILEFL 

| | | 10 | 

{ { | 08 | ZPUTFL 

| | | O08 | ZGETFL 

| { | 02 | ZPTRFL 

i | 01 | ZRODFL 
| i | 

| ZFLAGS | +20 | ° 80 | ZFTASK 

| } 40 | ZDENFL 

i | 20 | ALCSLM 

| | | 10 | 

| | } os | 

| | ; o8 | 

| | } o2 | 

| | ieee 

| ZFLAG6 | #21 | 80 | ZUNAFL 

{ | ; 40 | 

| | } 20 | 

| | | 10 | 

| | | os | 

{ | | o4 | 

| | ; o2 | 

| | {| o1 | 

[ a ee, a ee Kee (ake Nee eee ees 
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DESCRIPTION 
Bits are set on, on encountering:- 


DEFINED attribute 

ALLOCATE statement 

Second File statement 
Dimension attribute 
CHECK/NOCHECK prefix 

ON, SIGNAL or REVERT statement 
Structure 

DECLARE statement 


LIKE attribute 

STATIC INITIAL 

OPEN/CLOSE statement 

GET/PUT statement 

GO TO statement 

TASK/EVENT/PRIORITY options, REPLY statement 
PICTURE attribute/format item 

iSUB defining 


UNALIGNED(NONSTRING) attribute 
SETS attribute 

DELAY, DISPLAY, WAIT statement 
Argument list 

INITIAL Label 

DATA directed I/0 

RECORD I/0 

AUTO/CTL initialization 


FREE statement 

More than 256 statements 
Files present 

Spare 

PUT DATA 

GET DATA 

Pointer Qualifier 
STATIC DSA Entry 


TASK/EVENT/PRIORITY option on a CALL statement 


Set by FT 

ALLOCATE, with second level marker 
Spare 

Spare 

Spare 

Spare 

Spare 


ON for unaligned data: set by FU 
Spare 
Spare 
Spare 
Spare 
Spare 
Spare 
Spare 


1 ee 1 ee en ee een enw on ne 


on nn rn nn rn rr rn ne ee nf 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
3 


Table 4. 
in CCCODE. 
PS a Secon 


Byte|Bit | 


0 0 {DUMP 


Communications Region. Bit usage 


wanted 
not wanted 


abort has occurred 


tw a 


> 
ee 
n 
| 


not wanted 
wanted 


5 
5 


not wanted 
wanted 


not wanted 
wanted 


not wanted 
wanted 


* 
wD 
& 
vj 


not wanted 
wanted 


~l 


not wanted 
wanted 


.— 
=, 
3 
oF OF OF OF OF OF F OF 


| 
| 
ei 
4s 
| 


means U-format 
means F-format 
records on input 


oF 


» 


1 if track overflow 
is present 


Severity code 
Severity code 
Severity code 
Severity code 
where 0000=FLAGW 
0001=FLAGE 
0010=FLAGS 


WM SW N 


CHAR 48 not wanted 


1 
0 wanted 
1 
4] 


~! 
. 
6) 
Oo 


not wanted 
wanted 


ee ED GE een gee CUED eee ED ae ee ee ge ee ee ee ee 


-— 
: 
| 
: 
: 
: 
: 
| 


ee 


| Byte|Bit | | 


mmm fn a arn nnn rn nnn | 


2 0 |SOURCE not wanted 
wanted 


1 not wanted 


wanted 


Qa 
iS 


N 
w 
QD 
o 


BCD input 
EBCDIC input 
3 


SOURCE2 wanted 


not wanted 


= 
je) 
4] 
4 


wanted 
not wanted 


AE required 


Fe F&F OF OF OF OF OF 


no w 


program check 
has occurred 


~J 


1 means first record 
| has been read 

0 |STMT not wanted 

wanted 


3 


not wanted 
wanted 


wy 
5 
QD 
Lw, 
Q 
oa 


i 


not wanted 
wanted 


Q 
= 
rg 
Pe OF OF oF 


WwW 


macro phase now 
running 


batch record found 
batch record not 
found 


£ 


oF 
eee 


wn 


‘1 EOF record found 
0 EOF record not found| 


not used. requirement| 


~J an 


NEST 1 wanted | 
0 not wanted | 


eS en ne  E: | 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
t 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
L 
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APPENDIX G: SYSTEM GENERATION 


For full details of the system generation 


process, see IBM System/360 Operating 
Systems System Generation, Form C28-6554. 


During the system generation process, a 
control section named IEMAF (see Figure 13) 
is assembled containing a table consisting 
of a bit string field that is fourteen 
bytes in length, immediately followed by 
seven fixed-point values aligned on 
full-word boundaries. The first five 
fixed-point values are related to the 
compiler options LINECNT, SIZE, SORMGIN 
(start), SORMGIN (end), and PAGECTL 
(control column) respectively. The 


remaining two fixed-point values are spare 
fields not currently in use. Bits 0 to 25, 
28 to 46 and 51 to 53 in the string are 
used to specify the default status of the 
options. (Note: bit 51 is used for both 
default and delete.) Bits 54 to 81, and 83 
to 102 in the string are used to specify 
whether an option keyword is to be deleted 
or not. A "1" in the bit string means 
"yes" and a *0" means "no". The remaining 
bits in the string are spare bits not 
currently in use. Figure 14 shows the bit 
identification table associated with the 
control section. 


AP ES EE ND YD SY ES PS AP AE AS TY AD OA ES IE EN GAD SD ED A SD SP SD NS CE GD ED ae GS GED GN SS ES a ee Ee a ean es aaa aaa ae aaa saa | 


IEMAF START 


00000000! 


Dc B' io 0000000 


pc ar\ 0000000 


| 
po B'j0 0000000 00000000! 


| 
Dc B*J0 0000 ojo 0 


ee | 


pc B*j0 0000000 


| 
pe B'j0 0000000 00000000! 


De BJO 00000 0/0 00000000 


000000005! 


00000000" 


00000000! 


DEFAULT 


SWITCHES 


DELETE 


SWITCHES 


eames TO es ED comet aD QUT eee OD QD EOE 


SPARE SWITCHES | 


a oe ee a ae ee 4b ee a ee a a | 


| pc Pt60° 

Dc F'999999° 
Dc F‘2' 

pc F'72°" 

Dc F'O* 

| Dc Fto* 
\ 


eFigure 13. The IEMAF Control Section 
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is 
| 
| 
| 
| , | aaa 
| 
| 
| 
| 
| 
| 


(aoe oem ope we ce a ee ee et ee ee ee ee eee ee ee ee 


en ee 


Ce NS as en ae eS MG Ree Ee ape ye eee ee ean em ee TT .. 


| Bit | Parameter | Bit | Paramter | Bit | Parameter | 
}---+~-----—--------- }---+---------—--------------}---}------------------ 

| 0 | ATR |38 | NONEST {75 | DELETE=SOURCE2 | 
{| 1 | NOATR {39 | COMP {76 | DELETE=NOSOURCE2 | 
| 2 | BCD {40 | NOCOMP |77 | DELETE=OPT | 
| 3 | EBCDIC {41 | OBJIN {78 | DELETE=LINECNT | 
{| 4 | CHAR60 {42 | OBJOUT 179 | DELETE=LINELNG | 
| 5 | CHAR4SS {43 | MACDCK {80 | DELETE=SIZE | 
| 6 | DECK {44 | NOMACDCK |81 | DELETE=SORMGIN | 
{| 7 | NODECK {45 | EXTDIC {82 | Not used | 
| 8 | EXTREF {46 | NOEXTDIC {83 | DELETE=STMT | 
| 9 | NOEXTREF }47 | Not used {84 | DELETE=NOSTMT | 
{10 | FLAGW (48 | Not used {85 | DELETE=MACRO | 
}11 | FLAGE {49 | Not used {86 | DELETE=NOMACRO { 
{12 | FLAGS {50 | Not used |87 | DELETE=COMP | 
{13 | List {51 | DEFAULT/DELETE {88 | DELETE=NOCOMP { 
{14 | NOLIST | | (Bit always 0) {89 | DELETE=OBJIN | 
}15 | LOAD {52 | LIB=REAL {90 | DELETE=OBJOUT | 
}16 | NOLOAD j53 | LIB=COMPLEX {91 | DELETE=PAGECTL | 
{17 | XREF {54 | DELETE=ATR {92 | DELETE=MACDCK | 
{18 | NOXREF {55 | DELETE=NOATR }93 | DELETE=NOMACDCK | 
{19 | SOURCE {56 | DELETE=BCD {94 | DELETE=EXTDIC | 
{20 | NOSOURCE }57 | DELETE=EBCDIC {95 | DELETE=NOEXTDIC | 
{21 | SOURCE2 {58 | DELETE=CHAR60 {96 | DELETE=OPLIST | 
{22 | NOSOURCE2 {59 | DELETE=CHAR48 {97 | DELETE=NOOPLIST | 
{23 | opT=0 {60 | DELETE=DECK {98 | DELETE=NEST { 
{24 | OPT=1 {61 | DELETE=NODECK {99 | DELETE=NONEST { 
{25 | opr=2 {62 | DELETE=EXTREF {100| DELETE=SYNCHKE | 
[26 | Not used {63 | DELETE=NOEXTREF {101| DELETE=SYNCHKS | 
{27 | Not used {64 | DELETE=FLAGW }102| DELETE=SYNCHKT | 
{28 | SYNCHKE {65 | DELETE=FLAGE }103| Not used | 
{29 | SYNCHKS {66 | DELETE=FLAGS {104{ Not used { 
{30 | SYNCHKT {67 | DELETE=LIST {105| Not used | 
{31 | OPLIST {68 | DELETE=NOLIST }106| Not used { 
{32 | NOOPLIST {69 | DELETE=LOAD {107| Not used | 
{33 | STMT {70 | DELETE=NOLOAD |108| Not used | 
{34 | NostTMT {71 | DELETE=XREF {109| Not used | 
{35 | MACRO {72 | DELETE=NOXREF {110| Not used | 
{36 | NOMACRO |73 | DELETE=SOURCE {111| Not used | 
{37 | NEST {74 | DELETE=NOSOURCE | | | 
| aepeg Serene leer aise yee Bea SE ei a a ee en iad 


eFigure 14. Bit Identification Table 
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APPENDIX H: CODE PRODUCE FOR PROLOGUES AND EPILOGUES 


The mechanism of dynamic storage management 
is described in the publication IBM 


System/360 Operating System, PL/I 


Subroutine Library Program Logic Manual. 


Part of the code required to implement 
the storage management is generated as 
prologue and epilogue code by the compiler. 
This Appendix contains annotated examples 
Of prologues and epilogues for PROCEDURE, 


BEGIN, and ON blocks. 


PROLOGUES AND EPILOGUES 


Example in PL/I 


A:I: PROCEDURE(X, Y); 
DECLARE Y. CONTROLLED; 


ON OVERFLOW C=0; 


AB: IJK: ENTRY (Y,Z) 


e ® 8 ee @ 6 e =e 6 


RETURN (EXPRESSION) 


END; 


BC 15,16, (0,15) 
Dc Ali (1) 
pc Cat 


SIZDSA DC F" SIZE OF DSA‘ 


STATIC Dc 


+ + 
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A(STATIC CONTROL 
SECTION) 
STM 14,11,12, (13) 


LR 10,15 


BAL 8,GETDSA(0,10) 
MvI SWITCH (13) ,x‘X1' 


BC 15, COPRAM1 (0,10) 


BRANCH ROUND FOLLOWING CONSTANTS 
LENGTH OF BCD 
BCD OF ENTRY POINT 


ADDRESS OF STATIC INTERNAL CONTROL SECTION 
(ONLY COMPILED FOR EXTERNAL AND ON PROLOGUES) 
SAVE STANDARD REGISTERS IN SAVE AREA OF 
CALLER'S DSA 

SET UP FIRST PROLOGUE BASE 

CALL ROUTINE TO GET DSA 

INSERT RETURN (EXPRESSION) SWITCH 

(ONLY COMPILED IF THERE IS A RETURN (EXP) 
AND THE ENTRY LABELS HAVE DIFFERENT DATA 
ATTRIBUTES) 

BRANCH TO COPY OVER PARAMETERS 


ADPRIM 


* 


GETDSA 
* 


LOOP 


IP 
COPRAM1 


HEED 


+e + & 


+ 


HEKEE 


BC 
BC 
pbc 
pe 


ttt mee 


BAL 
BCR 


MVI 


BALR 


st 


L 


st 
LA 
SR 
st 


MVI 


15,10(0,15) 
AL1 (1) 

crx" 

A(A) 
14,11,12(13) 


10,ADPRIM(0,15) 
8,IP(0,10) 
11, STATIC(0,10) 


0,STZDSA(0,10) 
15,32, (0,11) 


14,15 

14,13 

0,7,(0,0) 

15,15 

14,0(0,11) 

14, ADVEC+4 (15,13) 
15,4(0,15) 
0,LOOP (0,10) 
15,8 
SWITCH (13) ,X'X2° 
14,0(0,1) 
14,X(0,13) 
14,4(0,1) 
0,10(0,0) 

14,0 

14,0(0,14) 
14,Y(0,13) 
14,8(0,1) 

14, TARGET (0,13) 
10,A...A(0,11) 


8,COMMON (0,10) 
15,10 


96(13) ,x'80° 


10,0 
9,ADDAREA(0,13) 


9, ADVEC (0,13) 


BRANCH ROUND FOLLOWING CONSTANTS 

LENGTH OF BCD 

BCD OF ENTRY POINT 

FIRST PROLOGUE BASE ADDRESS 

SAVE STANDARD REGISTERS IN SAVE AREA OF 
CALLER'S DSA 

SET UP FIRST PROLOGUE BASE 

SET RETURN REGISTER 

SET UP STATIC DATA POINTER (ONLY IN 
EXTERNAL PROCEDURES AND ON PROLOGUES) 
GRO=SIZE OF DSA 

LOAD GR15 WITH ENTRY POINT OF IHESADA 
(UNLESS DSA IS IN STATIC, WHEN ENTRY POINT OF 
COMPILER'S ‘GET DSA‘ ROUTINE WILL BE LOADED) 
CALL ROUTINE TO GET A NEW DSA 

POINT GR14 AT NEW DSA 

SET LOOPING VALUE = 7 

CLEAR INDEXING REGISTER 

BUMP GR14 BY 4096 

STORE GR14 IN ADDRESSING VECTOR 

BUMP INDEX REGISTER 


BRANCH ON RETURN REGISTER 

INSERT RETURN (EXP) SWITCH 

PICK UP FIRST ARGUMENT ADDRESS AND 
STORE IN X IN DSA 

PICK UP SECOND ARGUMENT ADDRESS 


POINT GR14 AT PSEUDO-REGISTER OFFSET OF 
ARGUMENT AND PICK IT UP 

STORE OFFSET IN Y¥ IN DSA 

PICK UP ADDRESS OF TARGET FIELD 

AND STORE IN DSA 

LOAD GR10 FROM TRANSFER VECTOR SLOT 
FOR ENTRY POINT A IN STATIC. 

BRANCH AND LINK TO COMMON PROLOGUE 
BRANCH TO THE APPARENT ENTRY POINT 
FOR A 

SET DSA TASKING FLAG (ONLY COMPILED 
IF TASKING IN COMPILATION) 

SET UP COMMON PROLOGUE BASE 

SET GR9Y TO POINT TO ADDRESSING AREA 
AT END OF DSA 

AND STORE IN ADDRESSING VECTOR. 


THE FOLLOWING CODE APPEARS 
ONLY IN THE CASE OF RECURSIVE PROCEDURES 


14,PR...A(12) 


14,92(0,13) 
14,PR...A(12) 
14,12 
14,88(0,13) 


INITIALIZE ON SLOTS (IF 


0(13),X'8F* 


LOAD GR1i4 WITH THE CURRENT DISPLAY 
VALUE FOR A 
STORE IN DISPLAY UPDATE IN DSA 


GR14 = OFFSET OF DISPLAY PSEUDO-REGISTER 
STORE IN DISPLAY UPDATE IN DSA 


ANY) 
IDENTIFY DSA. 


COPY SKELETON DOPE VECTORS (IF ANY) FROM STATIC INTERNAL 
CONTROL SECTION TO REAL DOPE VECTORS IN DSA. (THERE IS ALWAYS A 
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* 


* 


VDA1 


VDA2 


AB 


IJK 


PROBAS 


* 


COPRAM2 
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SKELETON FOR A REAL DOPE VECTOR), AND RELOCATE THE ADDRESSES WITH THE 


ADDRESS OF THE DSA FOR THOSE DOPE VECTORS REFERRING TO VARIABLES 
IN THE DSA. 


PROCEDURE 


FOR EACH VDA (VARIABLE DATA AREA) REQUIRED BY THE 


GENERATED 


SR 
SR 


GENERATED 


o~ 


THE CODE BETWEEN THE LABELS VDA1 AND VDA2 IS 


CLEAR STORAGE ACCUMULATOR AC1 
CLEAR SECONDARY DOPE VECTOR STORAGE 
ACCUMULATOR AC2 


FOR EACH VARIABLE IN THE VDA, THE FOLLOWING CODE IS 


(BETWEEN LABELS VAR1 AND VAR2). 


EVALUATE EXTENT EXPRESSIONS (DIMENSIONS AND STRING LENGTHS) AND 
STORE RESULTS IN DOPE VECTOR IN DSA. 


ALIGN ACCUMULATOR AC1 


ON CORRECT BOUNDARY FOR VARIABLE 


BUMP ACCUMULATOR AC2 BY SIZE OF SECONDARY DOPE VECTOR (IF VARIABLE 


IS DIMENSIONED AND VARYING). 


RELOCATE ADDRESS IN VARIABLES DOPE VECTOR RELATIVE TO START OF 


VDA. 


BUMP ACCUMULATOR AC1 BY SIZE OF STORAGE REQUIRED FOR VARIABLE 


AR 

L 
BALR 
LA 
AR 
L 
AR 
st 


0,7 


15, 36(0,11) 


14,15 
1,8(0,1) 
7,1 


14,DV..VAR(0,13) 


14,1 


14,DV.-.VAR(0,13) 


ADD AC1 AND AC2 

LOAD GR15 WITH ENTRY POINT IHESADR 

GET VDA 

BUMP VDA POINTER PAST FLAG AND CHAIN SLOTS 
POINT GR7 AT FIRST SECONDARY DOPE VECTOR. 
FOR EACH VARIABLE IN REGION, RELOCATE 
ADDRESS IN DOPE VECTOR. 


FOR EACH DIMENSIONED VARYING ITEM IN REGION, INITIALIZE 


SECONDARY DOPF VECTORS. 
10, PROCBASE 


LA 


BCR 
CNOP 
BC 
DC 
pe 
STM 
L 
BAL 


15,8 
0,4 


15,8(0,15) 


AL1 (2) 
C*AB* 


14,11,12(13) 
10, PROBAS (0,15) 
8,GETDSA (10) 


SWITCH (13) ,X'X3' 


15, COPRAM2 (0,8) 
15,12(0,15) 


AL1 (3) 
C*IOK" 
A(A) 


14,11,12(13) 
10, PROBAS (0,15) 
8,GETDSA(0,10) 


SWITCH (13) ,X‘*X4!* 
14,0(0,1) 
0,10(0,0) 


SET UP PROCEDURE BASE 

CODE (IF ANY) TO SET UP SOME ADDRESSING MECHANISMS It 
ADVANCE FOR USE IN PROCEDURE 

RETURN FROM COMMON PROLOGUE. 


BRANCH ROUND BCD OF ENTRY POINT 


SAVE REGISTERS IN CALLER'S SAVE AREA 
SET UP FIRST PROLOGUE BASE 

BRANCH AND LINK TO GET DSA AND TO SET 
UP ADDRESSING VECTOR 

SET UP RETURN (EXP) SWITCH IF THERE IS 
RETURN (EXP) AND DATA ATTRIBUTES OF 
ENTRY LABELS DIFFER 

BRANCH TO COPY OVER PARAMETERS 

BRANCH ROUND FOLLOWING CONSTANTS 
LENGTH OF BCD 

BCD OF ENTRY POINT 

FIRST PROLOGUE BASE 

SAVE REGISTERS IN CALLER'S SAVE AREA 
SET UP FIRST PROLOGUE BASE 

BRANCH TO GET DSA AND SET UP 
ADDRESSING VECTOR 

SET RETURN (EXP) SWITCH 

PICK UP FIRST ARGUMENT ADDRESS 


LOOP 


COMMON 
+ 
* 


ONSTART 


LOOP 


SR 
LH 
ST 
L 
st 
L 
ST 
L 


BAL 
BC 


14,0 

14,0(0,14) 
14,Y(0,13) 
14,4(0,1) 
14,2(0,13) 
14,8(0,1) 

14, TARGET(0,13) 
10,A...A(0,11) 


8, COMMON (0,10) 
15,AE...AB(0,10) 


PICK UP PSEUDO-REGISTER OFFSET OF 
ARGUMENT AND STORE IN DSA. 

PICK UP ADDRESS OF SECOND ARGUMENT 
AND STORE IN Z 

PICK UP ADDRESS OF TARGET FIELD 

AND STORE IN DSA 

LOAD GR10 WITH ADDRESS OF FIRST BYTE 
OF PROCEDURE 

BRANCH AND LINK TO COMMON PROLOGUE 
BRANCH TO APPARENT ENTRY POINT AB 


THIS IS THE APPARENT ENTRY POINT OF A. 


THE FOLLOWING IS AN ON BLOCK PROLOGUE WHICH IS COMPILED FOR ALL 
ON BLOCKS EXCEPT IF BLOCK SPECIFIES SYSTEM 


STM 
LR 


L 
L 
L 
BALR 


BALR 


14,11,12(13) 
10,15 


11, STATIC (0,10) 


-15,32(0,11) 


0,SIZDSA(0,10) 
14,15 

14,13 

0,7(0,0) 

15,15 
14,0(0,11) 

14, ADVEC+4 (15,13) 
15,4(0,15) 

0, LOOP (0,10) 
15, COMMON (0, 10) 
F'SIZE OF DSA' 


SAVE REGISTERS 
SET PROLOGUE BASE 


SET UP STATIC INTERNAL DATA POINTER 
LOAD GRi5 WITH ADDRESS OF IHESADA 
LOAD GRO WITH SIZE OF DSA 

CALL IHESADA TO GET A DSA 


SET UP ADDRESSING VECTOR IN 
DSA 


BRANCH TO INITIALIZE DSA 


A(STATIC INTERNAL CONTROL SECTION) 


10,0 


CODE IS GENERATED HERE FOLLOWING SAME PATTERN AS FOR 
A BEGIN PROLOGUE (SEE BELOW) COMMON SECTION. 


LA 


10, ONSTART 


EPILOGUE FOR AN ON BLOCK 


L 
BALR 


15, IHESAFA (0,11) 
14,15 


PROLOGUE FOR A BEGIN BLOCK 


LA 
BALR 
CNOP 
STM 
BALR 
L 

L 
BALR 
LR 


SR 


14, BEND 

15,0 

0,4 
14,11,12(13) 
9,0 

15,32(0,11) 
0,SIZDSA(0,9) 
14,15 

14,13 

0,7(0,0) 

15,15 
14,0(0,11) 

14, ADVEC#4 (15,13) 
15,4(0,15) 

0, LOOP (0,9) 

15, COMMON (0, 9) 
F'SIZE OF DSA' 
9, ADDAREA (0,13) 


LOAD GR15 WITH ENTRY POINT TO EPILOGUE 
ROUTINE AND BRANCH AND LINK TO IT 


SET UP RETURN REGISTER 
SET UP ENTRY POINT ADDRESS 


SAVE REGISTERS IN CONTAINING BLOCK'S DSA 
SET UP PROLOGUE BASE 
LOAD GR1i5 WITH ENTRY POINT TO IHESADA 


GET A DSA 


SET UP ADDRESSING VECTOR FOR DSA 


SET GRG TO POINT TO ADDRESSING AREA 
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BEND 


“eee he & & 
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ST 9,ADVEC (0,13) 
VECTOR 


AT END OF DSA AND STORE IN ADDRESSING 


THE CODE GENERATED HERE IS THE SAME AS THAT FOR A PROCEDURE PROLOGUE 
EXCEPT THAT A DIFFERENT CODE BYTE IS MOVED TO THE FIRST BYTE OF THE 


DSA; GR10 IS NOT RESET; 


EPILOGUE OF A BEGIN BLOCK 
L 15, IHESAFA 
BALR 14,15 


RETURN 


(EXP) STATEMENT EXAMINES THE LOCATION 


AND THE BCR 15,8 IS NOT GENERATED. 


LOAD GR15 WITH ENTRY POINT OF 
EPILOGUING ROUTINE AND CALL IT 


"SWITCH' IN THE DSA 


SET BY THE PROLOGUE TO DETERMINE THE CONVERSION REQUIRED ON 


THE EXPRESSION. 


POINTS TO EITHER ITS DOPE VECTOR 
OR THE STORAGE. 


*TARGET', 
(IN THE CASE OF A STRING) 
ROUTINE IHESAFA IS THEN INVOKED. 


IT THEN ASSIGNS THE CONVERTED EXPRESSION TO 
THE TARGET FIELD FOR WHICH THE LOCATION 


IN THE DSA, 


END STATEMENT (WHICH IS THE SAME AS A RETURN STATEMENT) 


L 15, [THESAFA 
BALR 14,15 


DSA OPTIMIZATION 


In corpilations specifying OPT=1, if a 
PROCEDURE or BEGIN block has a DSA which 
requires less than 512 bytes of storage, 
such storage may, under certain conditions, 
be obtained from STATIC storage or from 
library workspace. To obtain a STATIC DSA, 
the block must satisfy these conditions: 


1. The block must not be re-entrant or 
recursive 


2. The block must not be nested (at any 
depth) within an ON block 


3. The block must not have the MAIN or 
TASK options 


A block which is ineligible for a STATIC 
DSA, and whose DSA will never be active 
when any new DSA is required, is allocated 
its DSA from library workspace. 


Each block requiring a DSA either in 
STATIC or in library workspace calls one of 
two compiled subroutines, instead of 
IHESAD, to allocate the storage. Either or 
both subroutines, if required, are compiled 
onto the end of the program, and are 
prefixed by the comments ‘STATIC PROLOGUE 
SUBROUTINE and ‘DYNAMIC PROLOGUE 
subroutine’ respectively. Entry may be 
made to the STATIC prologue subroutine at 
one of several points. 


Any block using one of these prologue 
subroutines will also use a compiled 
Epilogue subroutine, which will be called 
for the END statement of the block, or for 
a RETURN statement without an expression. 


‘subroutine will call IHESAFA. 


(The same Epilogue subroutine serves both 
STATIC and library workspace DSAs.) If 
there is any core to be freed, the Epilogue 
The Epilogue 
subroutine is also compiled onto the end o! 
the program, and always immediately 
precedes the STATIC Prologue subroutine if 
this is present. 


The address of the Dynamic Prologue 
subroutine and the Epilogue subroutine are 
placed in the STATIC internal control 
section, at offsets 40 and 48 from the 
start respectively. Since the STATIC 
Prologue subroutine always follows the 
Epilogue subroutine, which is of fixed 
length, a third address slot is not 
required for it. 


Listings of the Dynamic and Static 
Prologue and the Epilogue subroutines 


* DYNAMIC PROLOGUE SUBROUTINE 
L 5,PR..THEQLWF (12) 
LTR 5,5 
BC 8,90(15) 

L 6,PR..THEQINV (12) 
LTR 6,6 

BC 4,90(15) 

LR 13,5 

SR 2,2 

L 3,PR..ITHEQSLA (12) 
ST 13,PR..IHEQSLA(12) 
ST 3,4(13) 

TM 0(3),X*80° 

BC 1,52(15) 

L 3,4(3) 

B 36 (15) 

st 13,8(3) 

L 4, PR. .IHEQINV(12) 


4,1(4) 


4,PR..IHEQINV(12) 
ST 4,84(13) 
ST 2,80(13) 
ST 2,8(13) 
MvI1I 76 (13) ,X* 00° 
st 2,96(13) 
BR 14 
L 15,32 (11) 
BR 15 


END SUBROUTINE 


EPILOGUE SUBROUTINE 


T™ 1(13),X'80" 

BC 8,60(15) 

L 2,80(13) 

LTR 2,2 

BC 7,60(15) 

Cc 13, PR... IHEQSLA (12) 
BC 7,60(15) 

L 13,4(13) 

ST 13,PR.. IHEQSLA (12) 
T™ 0(13) ,X"80* 

BC 1,50(15) 

L 13,4(13) 

B 34(15) 

ST 2,8(13) 

LM 14, 11,12(13) 

BR 14 


L 15,A..IHESAFA 
BR 15 
* END SUBROUTINE 
. STATIC PROLOGUE SUBROUTINE 
L 4, PR. . IHEQINV (12) 
LTR 4,4 
BC 11,86 (15) 
L 7, PR. . IHEQLWO (12) 
MVC 80(4,3) ,80(7) 
LA 4,1(4) 
ST 4, PR. .IHEQINV(12) 
ST 4,84(3) 
MVI 76 (3) ,x* 00° 
Sst 3,8(13) 
LR 13,3 
L 3, PR. . IHEQSLA (12) 
ST 3, 4(13) 
st 13,PR..IHEQSLA(12) 
SR 2,2 
ST 2,80(13) 
st 2,8(13) 
st 2,96(13) 
BR 14 
* END SUBROUTINE 
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APPENDIX I: 


DIAGNOSTIC _MESSAGES 


The messages produced by the PL/I (F) 
Compiler are explained in the publication 


IBM System/360 Operating System, PL/I (F) 


Programmer's Guide. 
associates a message number with the 


particular phase and module in which the 
corresponding message is generated. 


Message 
Number 


IEMO001I 
IEMO002I 
IEM0003I 
IEMOOO4I 
IEMO005I 
IEMO006I 
IEMO007I 
IEMO008I 
IEM00091 
IEMO010I 
IEMO0111 
IEM0012I 
IEM00131 
IEM00141 
IEMO015I 
IEMO016I 
IEMO0171 
IEMO0181 
IEMO0191 
IEM0020I 
IEM0021I 
IEMO00 221 
IEM00231 
IEM00 241 
IEM0025I 
IEMO0 261 
IEMO0271I 
IEMO0281 
IEM00291 
IEMOO0311 
IEM00331 
IEM0035I 
IEM00371 
IEM00381 
IEM0039I 
IEMO040I 
IEM00431 
IEMO044I 
IEMOO45I 
IEMOO461 
IEMOO48I 
IEMO0501 
IEMO0511 
IEM0052I 
IEM00531 
IEMO0541r 
IEMOO55I 
IEMO0571 
IEM00581 
IEMO059I 
IEM0060I 


466 


Logical Phase 


Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 


In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 


The following table 


CA 
CA, CL,CT 
ce 


cc 
cc 
cc 
ce 
cc 
cc 
cc 
cc 
cc 
CG 
CL,CP 
CL, CP 
Co 
co 
co 
CP 
cc 
cc 
cP 
CP 


IEM0061I 
IEM00631 
ITEMOO64I 
IEM00671 
IEMO069I 
IEM007 01 
IEMO0071I 
IEM007 2I 
IEMO0074I 
IEM0075I 
IEMO0076I 
IEM0077I 
IEM00781I 
IEM008 01 
IEMO081TI 
IEM0082I 
IEMO083I 
IEMO084I 
IEMO 0851 
IEMO090I 
ITEMO094TI 
IEMOO95I 
IEM0096I 
IEM0097I 
IEMO0099I 
IEMO100I 
IEM0101I 
IEMO01021I 
TEM01031I 
IEM01041 
IEM0105I 
IEM01061 
IEM01071 
IEM0108I 
IEM0109TI 
IEM01111I 
IEM011 21 
IEM01131 
TEMO1141 
IEMO0115I 
IEM01161 
IEMO01171 
IEM01181I1 


IEM0119I 


IEM01201 
IEM01211I 
IEM01221 
IEM01231I 
IEM01241 
IEM0125I1 
IEM01261 
IEM01271I 
IEM0128I 
IEM01291 
IEM0130I 
IEM01311 
IEM01321 
IEM013 41 
IEMO0135I 
IEM0136I 
IEM0138I 
IEM01391 


Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 
Read 


In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 


In 
In 
In 


In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 
In 


cP 
co 
cc 
CL 
CG 
CG 
CG 
CG 
CG 
CG 
CG 
CG 
CG 
CG 
CG 
CI 
CG 
CG 
CI 
cI 
cI 
CI 
CG,CI 
CI 
CI 
cI 
cM 
cI 
CI 
cc 
cc, CG 
cI,CcV 
cI 
CI 
CG, CI 
CI 
cI 
CG,CM 
cI 
CL 
CI 
CM 
CL 
CM 
cM 
co 
co 
CM 
co 
cI 
cI 
cI 
co 
CL 
cL 
co 
co 
cP 
CG, CI 
co 
cP 
cP 


IEMO140I 
IEMO1411 
IEMO1441 
IEM01451 
IEM01471 
IEMO149I1 
IEMO1501 
IEM01511 
IEMO1521 
IEM01531 
IEMO154I 
IEMO158I 
ITEMO01591 
IEM01631 
IEMO01661 
IEMO1721 
IEMO180I 
IEMO1811 
IEMO182I1 


IEMO1851 
TEM01871I 
TEMO1911 
IEM01931 
IEMO194TI 
IEMO195I 
IEMO1981 
IEMO 2021 
IEM0207I 
IEMO 2081 
ITEMO2091 
ITEMO0 2111 
IEMO 2121 
IEMO 2131 
IEM02141 
IEMO 2161 
IEMO02171I 
IEMO2201 
IEMO 2211 
IEM0222I 
TEMO 2231 
IEMO2241 
IEMO 2251 
IEM02261 
TEMO 2271 
IEMO228I 
IEMO 2291 
IEMO 2301 
TEMO231I 
IEMO 2321 
IEMO 2331 
IEMO 2351 
IEMO2361 
IEMO0 2371 
IEM02381 
IEMO 2391 
TEMO2401 
IEMO241T 
IEMO 2421 
ITEMO243I 
TEMO 2441 
TEMO245I 
TEMO 2471 
TEM0254&I 
ITEMO 2551 
TEMO5101 
IEMO5111 
IEMO5121 
IEMO5131 


Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 


Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Read In 
Dictionary 
Dictionary 
Dictionary 
Dictionary 


co 


co 
co 


CL,CM 
co 

co 

CA 

co 

co 

CL 

cT 
CL,CS, 
CT,CV 
cT 


cT 


cT 
cL 
CG 
CG 
ce 
cL 
cP 
CP 
cT 
ct 


ct 
ct 


Cs,cCT 
CT. 
cs 

cS 

cs 

CV 

CS 

CV 
CV 
CV 


CW 
cc 


EH 


EH 


IEMO5141I 
IEM0515I 
IEMO516I1 
IEMO05171 
IEM0518I 
IEM0519I 
IEM05201 
ITEM05211 
IEM0522I 
IEM05231 
ITEM05241 
IEM05251 
IEM05271I 
IEM05 281 
IEM05291 
IEMO530I 
IEM05321 
IEM05331 
TEMO5341 
IEMO535I1 
IEMO05361 
ITEM05371 
IEM053 8I 
IEMO053 9I 
IEM054 01 
IEMO54811 
ITEM05421 
IEMO05431 
IEMO544TI 
IEM0545I 
IEMO54 61 
IEM0547I 
IEM054 81 
IEM054 91 
TEMO5501 
IEMO5511 
IEMO5521 
TEM05531 
IEMOS54&I 
IEMO555I 
IEMO5561 
ITEM05571 
IEMO0558I 
IEM05591 
TEM0560I 
IEMO5611 
ITEM056 21 
IEM05631 
IEMO5641 
IEMO5651 
IEM05661 
IEMO5671I 
IEM05681 
IEM056 91 
IEM057 01 
IEM05711 
IEM05721 
IEM057 31 
IEMO05761I 
IEM05771 
IEM05781 
IEMO05791I1 
ITEMO058 01 
IEMO589I 
IEMO590I 
IEM05911 
IEM0592I 
IEM05931 
IEMO0594I 


Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 


EJ 


EL, EK, EM 
EL ,EK, EM 
EL, EK, EM 
EL ,EK, EM 
EL, EK, EM 
EL, EK, EM 
EK, EL, EM 
EK, EL, EM 
EK, EL, EM 
EK, EL, EM 
EK ,EL,EM 
EP 
EP 
EP 
EP 
EK 
EL 
EL 
EL 
EL 
EL 
EP 
FI 
EW 
EW 
EW 
EW 
EW 
EW 
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IEMO5951 
_ IEMO5961I 
IEM05971 
IEMO598T1 
IEM0599I 
IEM0602I 
IEMO06031I 
IEMO604&1 
IEM06052 
IEM06 061 
IEMO6071 
IEM06 081 
IEMO6091 
IEM06101 
IEM06111 
IEM0612I 
IEM06131 
IEMO06141I 
IEM06231 
IEM06241 
IEM06251 
IEM06 261 
IEM06281 
IEM06291 
IEMO6301 
IEMO 6311 
IEM06321 
IEM06331 
IEMO6341 
IEM06361 
IEM06371 
IEM06381 
IEMO6401I 
IEM06 412 
IEMO6421 
IEM06431I 
IEMO6441 
TEM06451 
IEM06461 
IEMO647I 
IEMO06531 
IEMO06551I 
IEMO656I 
IEM06571I 
IEM06581 
IEMO 6601 
IEM06611I 
IEM0662I 
IEM0673I 
IEM06741 
IEM06751I 
IEM0676I 
IEM06771 
IEM06821 
IEM06831 
IEMO6841 
IEM06851 
IEM0686I 
IEM06871 
IEMO06881 
IEM06891 
IEM06 901 
IEM06911 
IEM0692I 
IEM06931 
IEMO 6941 
IEM0695I 
IEM06961 
IEM0697I 


468 


Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 


Pretranslator 


Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 


EW 
EW 


EW 
FV, FW 
FV,FW 
FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV 


FW 

FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV, FW 
FV,FW 


IEMO06981 
IEM06991 
IEMO700I 
IEM0701I 
IEMO702I 
IEMO07031 
IEMO704I 
IEM07051 
IEMO7061 
UEM07071I 
IEMO715I1 
IEMO7181 
IEM07191I 
IEM07201 
IEMO7211I 
IEM0722I 
IEMO7231 
IEMO724I 
IEMO7251 
IEMO7261 
IEM07271 
IEMO7281 
IEM072 91 
IEM0730I1 
IEM07311 
IEM0732I 
IEM07331I1 
IEMO7341 
IEMO735I 
IEM073 61 
IEM07371 
IEM073 91 
IEMO740I 
IEMO741I 
IEM0742I 
IEM0745I 
ITEMO7461 
IEMO747I 
IEMO074&81I 
IEMO74 9I 
IEMO750I 
IEMO7511 
IEMO752I 
IEMO754I 
IEMO755I 
IEMO756I 
IEMO758I 
IEMO7591I 
IEM0760I 
IEM0761I 
IEM07621 
IEM0769I 
IEM07701I 
IEM07711 
IEM0778I 
IEM07791 
IEMO780I 
IEM0781iI 
IEM0782I 
IEMO7861I 
IEMO7871I 
IEM07911I 
IEM07921 
IEM0793I 
IEMO794TI 
IEM0795I 
IEMO0796I 
IEM07971I 
IEM0798I 


Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Dictionary 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 


GK 

GP ,GQ,GR 
GP,GQ,GR 
GP, GQ, GR 
GP ,GQ,GR 
GP ,GQ, GR 
GP ,GQ,GR 
GP ,GQ,GR 


IEMO799I 
IEMO800I 
IEMO801I 
IEMO802I 
IEMO803I 
IEMO8O4ST 
IEMO0805I 


| IEMOs80SI 


Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretrans lator 
Pretranslator 


GP,GQ,GR 
GP,GQ,GR 
GP, GOQ,GR 
GP,GO,GR 
GP, GQ,GR 
GP,GQ,GR 
GP, GQ,GR 
GR 


IEM30521 
IEM38421 
IEM38431 
IEM38451 
IEM38461I 
IEM38471 
IEM384 81 
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Compiler Control 
Compiler Control 
Compiler Control 
Compiler Control 
Compiler Control 
Compiler Control 
Compiler Control 


AL/AN 
AL/AN 
AL/AN 
AL/AN 
AL/AN 
AL/AN 
AL/AN 


IEMO806T 
IEMO08071 
IEM08161 
IEM08171 
IEMO0818T1 
TEM0819I 
IEMO8 201 
IEMO8 211 
IEM08 231 
IEMO824I 
IEMO8251 
IEM08 261 
IEM08321 
IEM08331 
IEMO8 341 
IEM08351 
IEMO0836I 
ITEM08 371 
IEM0838I 
IEMO848T 
ITEMO849T 
IEMO850I 
IEMO08511 
IEMO8521 
IEMO8531 
IEMO864I 
IEMO865I 
IEMO866I 
IEMO8671I 
IEMO868I 
IEM08691 
IEMO870I 
ITEM08711 
IEM08721 
IEM08731 
IEM0874&I 
IEM08751 
IEMO08 761 
IEM08771 
IEM0878I 
IEMO879I 
IEMO880I 
IEMO8811 
IEM0882I 
IEMO8 961 
IEM08971I 
IEMO898I1 
IEM0899I 
ITEMO900I 
IEM09011 
IEM0902I 
IEM09031 
IEM09061 
IEM09071 
IEM1 0241 
IEM10251 
IEM10261 
IEM10271 
IEM10281 
IEM10291 
IEM1030I1 
IEM1 0401 
IEM10511 
IEM10561 
IEM10571 
IEM1 0581 
IEM10591 
IEM1 0601 


Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 


' Ppretranslator 


Pretranslator 


-Pretranslator 


Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Pretranslator 
Translator 

Translator 

Translator 

Translator 

Translator 

Translator 

Translator 

Translator 

Translator 

Translator 

Translator 

Translator 

Translator 

Translator 


GP,GQ,GR 
GP,GQ,GR 
GU, GV 
GU,GV 
GU, GV 
GU, GV 
GU, GV 
GU, GV 
GU, GV 
GU 
GU,GV 
GU, GV 
HF, HG 
HF, HG 
HF, HG 
HF, HG 
HF, HG 
HF, HG 
HF 
HF, HG 
HF, HG 
HF, HG 
HF, HG 
HF, HG 
HF, HG 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 
HK, HL 


IEM10611 
IEM1062I 
IEM10631 
IEM1064T1 
IEM10651 
IEM10661 
IEM10671 
IEM10681 
IEM107 01 
IEM10711 
IEM107 21 
IEM10731 
IEM10741 
IEM10761 
IEM108 21 
IEM1088I 
ITEM108 91 
IEM1090I 
IEM10911 
IEM10921 
IEM11041 
IEM1105I1 
IEM1106I1 
IEM11071 
IEM11081 
IEM11101 
IEM11111 
IEM11121 
IEM11131 
IEM11141 
IEM1115I1 
IEM11201 
IEM11211 
IEM11221 
IEM11231 
IEM1125I1 
IEM12001 
IEM12101 
IEM12111I 
LEM12201 
IEM12231 
ITEM12241 
IEM15691 
LTEM15701 
IEM15711 
IEM15721 
IEM15741 
IEM1575I1 
IEM15881 
IEM16001 
IEM16011 
IEM1602I 
IEM16031 
ITEM16041 
IEM1605I 
IEM1606I1 
IEM16071 
IEM16081I 
IEM16091 
IEM1610I1 
IEM1611I 
IEM1612I 
IEM16131 
IEM16141 
IEM1615I1 
IEM16161 
IEM16171 
IEM16181 


Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Translator 
Aggregates 
Aggregates 
Aggregates 
Aggregate Preprocessor 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Aggregates 
Ps eudo-code 
Pseudo-code 
Pseudo-code 
Do loop optimization 
Do loop optimization 
Do loop optimization 
Do loop optimization 
Do loop optimization 
Pseudo-code 
Ps eudo-code 
Pseudo-code 
Pseudo- code 
Ps eudo-code 
Pseudo-code 
Ps eudo-code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Ps eudo-code 
Pseudo-code 
Pseudo~code 
Pseudo-code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Ps eudo-code 
Pseudo-coide 
Ps eudo- code 
Pseudo-code 
Pseudo- code 
Pseudo-coie 
Pseudo-code 


LS, LT, LU 
LS 

LS, LT, LU 
LS, LT, LU 
LS, LT, LU 
LS, LT, LU 
LS, LT, LU 
LS, LT, LU 
LS, LT, LU 
LS, LT, LU 


LS, LT, LU 
LW 
ME 
ME 
MB 
MB 
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IEM16191 
IEM16201 
IEM16 211 
IEM16221 
IEM16241 
IEM16251 
IEM16 261 
IEM16271 
IEM16281 
IEM16291 
IEM1630I1 
IEM16311 
IEM1632I1 
IEM16331 
IEM16341 
IEM1635I1 
IEM16361 
IEM16371 
IEM16381 
IEM16391 
IEM16401 
IEM16411 
IEM16421I 
~IEM16431 
IEM16441 
IEM1645I1 
IEM16481 
IEM1649T 
IEM1650I 
IEM16511 
IEM16521 
ITEM16541 


IEM16551_ 


IEM16561 
IEM16571 
IEM16581 
IEM16701 
IEM16711 
IEM1680I1 
IEM16871 
IEM16881 
IEM16891 
IEM16921 
IEM16931 
IEM1695I 
IEM1 6961 
IEM17501 
IEM17511 
IEM1752I 
IEM17531 
IEM17541 
IEM17901 
IEM17 931 
IEM17941 
IEM17951 
IEM17961 
IEM1L7971 
IEM18 001 
IEM18011 
IEM18021 
IEM18031 
IEM18 041 
IEM1805T1 
IEM1806I 
IEM18071 
IEM1 8081 
IEM1809I 
IEM18101 
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Pseudo~-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-~-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo- code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 


- Pseudo-code 


Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 


IEM18111 
IEM18121 
IEM18131 
IEM18141 
IEM1815I 
IEM18161 
IEM18171 
IEM18181 
IEM18191 
IEM18201 
IEM18211 
IEM18221 
IEM18231 
IEM18241 
IEM18251 
IEM1826I1 
IEM18271I 
IEM18281 
IEM18291 
IEM1830I1 
IEM18311 
IEM1832I1 
IEM18331 
IEM18341 
IEM1835I1 
IEM18361 
IEM18371 
IEM1838I 
IEM1839I1 
IEM184 01 
IEM18411 
IEM18431 
IEM18441 
IEM1845I 
IEM18461 
IEM18471 
IEM1848I 
IEM18491 
IEM18501 
IEM1860I 
IEM18611 
IEM1862I 
IEM187 01 
IEM18711 
IEM187 21 
IEM18731 
IEM18741 
IEM18751 
IEM23041 
IEM23051 
IEM23521 
IEM26501 
IEM26601 
IEM26611 
IEM27001 
IEM27011I 
IEM2702I 
IEM27031 
IEM27041 
IEM27051 
IEM27061 
IEM27071 
IEM27081 
IEM27091 
IEM27101 
IEM27111 
IEM27121 
IEM28171 


Pseudo~-code 
Pseudo-code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo- code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Pseudo-code 
Ps eudo- code 
Pseudo-codje 
Pseudo-code 
Pseudo-code 
Ps eudo-code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 


Pseudo-code 


Pseudo-code 
Pseudo-code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Pseudo-code 


Constant Conversions 
Constant Conversions 


Ps eudo-code 
Pseudo-code 
Ps eudo-code 
Pseudo-code 
Ps eudo- code 
Pseudo-code 
Pseudo-code 
Pseudo-code 
Pseudo-code 


Storage Allocation 
Storage Allocation 
Storage Allocation 


Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 
Register 


Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 
Allocation 


DCB Generation 


RF, RG, RH 
RF, RG, RH 
RF, RG, RH 
RF, RG, RH 
RF, RG, RH 
RF,RG, RH 
RF ,RG, RH 
RF, RG, RH 
RF , RG, RH 
RF, RG, RH 
RF, RG, RH 
RF, RG, RH 
RF, RG, RH 
GA 


IEM2818T1 
IEM28191 
IEM28201 
IEM28 211 
IEM28 221 
IEM28231 
IEM28 241 
IEM28 251 
IEM28 261 
IEM28 271 
IEM28281 
IEM28 291 
IEM28301 
IEM28311 
IEM28321 
IEM28331 
IEM28341 
TEM28351 
IEM28361 
IEM28371 
IEM28521 
IEM28531 
IEM28 541 
IEM28551 
ITEM28651 
IEM2 8661 
IEM28671I 
IEM28681 
IEM28811 
IEM2882T 
IEM28831 
IEM28841 
IEM28851 
IEM28861 
ITEM28871 
IEM2888I1 
IEM28 971 
IEM28 981 
IEM28991 
IEM2900I1 
IEM29131 
IEM3 0881 


IEM3136I- 


31491 
IEM31511 


IEM31531 
IEM31541 
IEM31561 


IEM3162I1 


IEM31671I- 


31731 


IEM31761- 


31901 


IEM3199I- 


32131 
IEM3 5841 


IEM3840I 
IEM38411 
IEM3 8421 
ITEM38 431 
ITEM3 8441 


DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 
DCB Generation 


Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 
Final 


Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 
Assembly 


Dictionary, 
Pass 2 
Dictionary, 
Pass 2 
Dictionary, 
Pass 2 
Dictionary, 
Pass 2 
Dictionary, 
Pass 2 
Dictionary, 
Pass 2 
Dictionary, 
Pass 2 
Dictionary, 
Pass 2 


Declare 
Declare 
Declare 
Declare 
Declare 
Declare 
Declare 


Declare 


Dictionary, 


Pass 2 


Dictionary, 


Pass 2 


48 Character 
Preprocessor 


Compiler 
Compiler 
Compiler 
Compiler 
Compiler 


Control 
Control 
Control 
Control 
control 


Declare 


Declare 


EL 


EL 


EL 


EL 


EL 


te 
tc 


w 
ba 


BESES 


IEM38451 
IEM38461 


IEM38471 
IEM384 81 
ITEM38491 
TEM38501 
IEM38511 
IEM38521 
IEM38531 
IEM38551 
IEM38561I 
IEM38571 
IEM38581 
IEM38591 
ITEM38601 
IEM38611 
IEM3862I 
IEM38631 
IEM38641 
IEM38651 
IEM3866I 
IEM387 21 
IEM38731 
IEM38741 
IEM38751 
IEM387 61 
IEM38771 
IEM387 81 
IEM388 OI 
IEM38871 
IEM3888I 
ITEM388 91 
IEM38901 
IEM38911 
IEM389 21 
IEM38931 
IEM38941 
IEM3895I1 
IEM38961 
IEM38971 
IEM38981I 


IEM3899I 


IEM3900I 
IEM39011I 
IEM39021I 
IEM3902I 
IEM39031 
IEM39041 
IEM3905I 
IEM3906I 
IEM3907I 
IEM39081I 
IEM3909I 
IEM3910I 
IEM39111 
IEM39121 
IEM39131 
ITEM39141 
IEM41061 
IEM41091 
IEM411 21 
IEM41151I 
IEM41181 
IEM41211 
TEM41 241 
IEM&1301 
IEM41331 


Compiler 
Compiler 


Control 
Control 


Optimization 


Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 
Compiler 


Control 
Control 
Control 
Control 
Control 
control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
control 
Control 
Control 
control 
Control 
control 
Control 
Control 
Control 
Control 
Control 
control 
Control 
Control 
Control 
Control 
Control 


Control | 


Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 
Control 


Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 


Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 


SS ODP oe ea ahh Ob Dh OP Dh ea a aa ae a eS DD 


AS 

AS, BC, BG 
BC, BG 

BG 

BC 
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ITEM41341 
IEM41361 
IEM41391 
IEM41421 
ITEM41431 
ITEM41481 
IEM41501 
IEM41511 
IEM41521 
IEM4&1531 
ITEM41541 
IEM4i571 
IEM41601 
IEM41631 
IEM41661 
IEM41691 
IEM41721 
IEM41751 
IEM41761 
IEM41781 
IEM41841 
IEM41871 
IEM41881I 
IEM41901 
IEM4&41931 
IEM41961 
IEM41991 
IEM4 2021 
IEM4205I 
IEM4 2081 
IEM42111 
IEM4 2121 
TEM4 2141 
IEM4 2151 
IEM4 2171 
IEM42201 
IEM4 2231 
IEM4 2261 
IEM4&229T 
ITEM4 2321 
ITEM4 2351 
IEM4 2381 
ITEM4 2411 
TEM4 244 
IEM4 2471 
ITEMS 2481 
ITEM4250I 
IEM4 2531 
IEM4254aI 
ITEM4 2561 
ITEM42591 
IEM4 2621 
IEM4 2651 
> IEM&2711I 
ITEM4 2771 
IEM4& 2801 
IEM4 2831 
IEM4 2861 
IEM4 2891 
IEM4& 292T 
IEM4 2951 
TEM4 2961 
IEM4 2981 


IEM4299I 


IEM43011 
IEM43 041 
IEM43071I 
IEM43101I 
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Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 


Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 


‘Processor 


Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 
Processor 


IEM43131 
IEM43191 
IEM43221 
IEM4325I 
ITEM43261 
IEM4&3281I 
IEM43311 
IEM43321 
IEM43341 
IEM43371 
IEM43401 
IEM43431 
ITEM434 61 
ITEM43491 
IEM43521 
IEM43551 
IEM4&3581 
IEM4361I 
IEM4&364T1 
IEM43671 
IEM43701 
IEM43731 
IEM43761 
IEM437 91 
IEM43821 
IEM&#2831 
IEM43911 
IEMS394TI 
IEM43971I 
IEM44001 
IEM44031 
IEM4406r 
IEM4407T 
IEM4409I 
IEM44121 
IEM4415I 
IEM4&421I 
ITEM44331 
IEM4&43 61 
IEM44391 
TEMS44 8I 
IEM44511I 
ITEM4&452I 
ITEMS454I 


IEMS4571 | 
IEM44601 


IEM44631 
IEM4&4691 
IEM4&447 21 
IEM44731 
IEM4475I 
IEM446781 
IEM4&4sil 
IEM&4sat 
ITEM4499T 
ITEM45021I 
IEM4&504I 
IEM45051 
IEM4506I1 
IEM4508I1 
IEM45111 
IEM45141I 
IEM45171 
IEM45201 
IEM45231 
IEM45261 
IEM45291I 
IEM453 21 


Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 


Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor AV 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BC 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor BC 
Processor BG 
Processor BG 
Processor BG 
Processor BG 
Processor AS 


Processor BC,BG 


Processor AS 


| TEM45351 
IEM4 5471 
IEM45501 
IEM45531 
IEM45591 
IEM4562I 


Compile-time 


Compile-time 


Compile-time 
Compile-time 
Compile-time 
Compile-time 


Processor 
Processor 
Processor 
Processor 
Processor 
Processor 


IEM45701 
TEM45721 
ITEM45741 
IEM45761 
IEM45781 
IEM45801 


Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 
Compile-time 


Processor 
Processor 
Processor 
Processor 
Processor 
Processor 


BS 
BG 
BG 


BS 
BG 
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APPENDIX J: COMPILE-TIME PROCESSOR 


This appendix describes, for the 
Compile-time Processor Logical Phase, the 
internal formats of text and tables, 
communication region use, Operating System 
interfaces and compiler control interfaces. 


1. INTERNAL FORMATS OF TEXT 





The internal format of text used by the 
compile-time processor is EBCDIC. As 
source input is read into storage, 
non-macro text is moved directly into text 
blocks after translation to internal 
format. Encoded compile-time statements 
and line numbers are also placed in text 
blocks. 


Format of a Dictionary Entry 


The compile-time processor uses a set of 
chained dictionary entries. Hashing 
techniques are used to add an item to the 
dictionary or to search for an entry. A 
compile-time processor dictionary item is a 
variable-length item with the following 
skeletal format: 


The fields defined in this skeleton have 
the following meaning and usage: 


LENGTH: The length of the EBCDIC name. If 
the item has no name (e.g., a 
constant) this field is zero. 


PROC NO.: The number assigned to the 
procedure in which the identifier 


was declared. Each procedure is 
assigned a unique number. The 
identifiers in the non-procedural 
text are given the procedure number 
1. The built-in function SUBSTR is 
given the procedure number 0. 


HASH-CHAIN-POINTER: The dictionary address 
of the next item on this hash 
chain. This address is zero if no 
item follows. 


TYPE: A byte which gives the attributes of 
the entry. The bits (if on) have 
been assigned the following 
meanings: 


BIT MEANING 


fixed 

character 

bit 

entry 

label 

INCLUDE identifier 
iterative DO 
constant 


NNO EINE O 


VALUE/VALUE-POINTER: If the item is fixed, 
this contains the value proper 
stored as a five-digit packed 
decimal number. Otherwise it 
contains a pointer to the value 
stored in IVBs. The definition of 
value for the various kinds of 
entries is given below. Fora 
fixed macro variable, this contains 
the value. For a character 
variable, it contains a pointer to 
IVBs containing the value. For a 
procedure, it points to the 
text-block location of the code. 


Byte 4 


Byte 1 Byte 2 Byte 3 
ees ara aera S--- 
Word 1 | LENGTH | PROC NO. | HASH-CHAIN-POINTER | 
Word 2 | TYPE | VALUE/VALUE- POINTER | 
p----------1-—--------,---------------------4 
Word 3 | FLAGS | COUNT | 
p--------------------- 4——-~-———~——-—-—~——----—~~-~— -4 
Word 4 | POINTERS/PARM-TYPES | 
a aha a ea ec ans a ec es r 
Word 5 | EBCDIC NAME ------> | 
bat ei eee ea eae ate ameateaaiond 
| | 
|--—----------------------------------------4 
Word n [| ------ > EBCDIC NAME | 
bai ede eee aaa enema ee eed 
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For a label, it points to the 
text-block location of the label. 
If references to the label are 
found before the label is 
discovered, the value pointer 
temporarily points to a chain of 
IVBs with a description of every 
GOTO transferring to this label. 
This information is processed and 
discarded when the label is found. 
For an INCLUDE identifier, it 
points to the beginning of the 
included text. 


FLAGS: This set of bits provides additional 
information about the use of the 


item. They are used as follows: 
BIT MEANING 
0 special entry bit 
1 DECLARE encountered (Phase 
BC) 
2 procedure body encountered 
(Phase BC) 
3 parameter 
4 used to indicate a procedure 
called by Phase II scan. 
5 DECLARE encountered (Phase 
BG) 
6 unused 
7 ACTIVATE bit 
8 "in-use" bit 
9 “indirect reference” bit 
10 "undefined® bit for multiple 


declarations 
11 left-hand side (LHS bit) 


This field occupies a half-word. 


COUNT: For a procedure entry, this field 
contains a count of the number of 
parameters for the procedure. For 
INCLUDE identifier it is zero 
initially, and subsequently 
contains the initial line number 
assigned to the included text. 


POINTERS/PARAM-TYPES: For a procedure, the 
field contains an encoding of the 
type information for each formal 
parameter. Two bits are reserved 
for each parameter. One indicates 
fixed; the other indicates 
character. If neither bit is set, 
this indicates that the entry 
declaration did not specify 
attributes for the parameters. 


For a label, word 4 contains two 
pointers to dictionary items. One 
points to the dictionary entry for 
the immediately embracing iterative 
DO. The second half-word contains 
a pointer to the dictionary entry 
for the immediately embracing 
INCLUDE. This provides a method of 
checking the legality of GOTOs. 


For an INCLUDE identifier, only the 
pointer to the immediately 
embracing INCLUDE is kept. 


During Phase I, word 4 is used for 
labels and simple variables to hold 
two pointers. These form a 
bi-directional chain of all labels 
and variables having the same 
procedure number which have been 
used but not defined. This 
information is used only in Phase I 
and can therefore be overlaid. 


EBCDIC NAME: A variable length field, 
containing the EBCDIC name of the 
item. If the item has no name, 
this field is not included. 


Format of an Identifier Value Block (IVB) 


To hold character and bit string values, 
some text blocks are organised into 
sub-blocks of 32 bytes each. Of these 32 
bytes, 27 are used to hold values or parts 
of values. The first byte is used to hold 
a copy of the last character in the 
preceding IVB. This copy is made to 
facilitate backup. The last four bytes 
consist of a condition code of one byte 
followed by a 3-byte chain pointer. A set 
of these sub-blocks, chained together, is 
used to hold a value. The condition byte 
is 27 for all except the last sub-block in 
a value. In this last condition code byte 
the first bit is set to 1 to indicate 
*"“end-of-value.* The remaining bits are a 
count of the significant bytes in the 
sub-block. There is a maximum of 27 
Significant bytes in an IVB. 


The chain address is used to point to 
the next sub-block in a value. The meaning 
of the chain address in the last sub-block 
in a chain depends on how the chain is 
being used. 


These small chained sub-blocks are 
referred to as “identifier value blocks," 
or IVBs. 


Text blocks are allocated to hold IVBs 
as the need arises. Those IVBs not 
currently in use are chained together into 
an availability chain and are re-used when 
needed. 


An example of a character string value 
held in IVBs is shown. The character 
string, which starts with AB and ends with 
CD, is 28 characters long. Two IVBs are 
thus required to hold the value. The 
string AB...C is put into the first IVB, 
while the last character, D, is put into 
another IVB. The condition code byte of 
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wo 


| ?AB eaee Cc | 


Lo. ee LL 


<----28------ > 1 3 


the first IVB is 27. The second condition 
code byte is 10000001. The first “%1" 
indicates end-of-value, while 0000001 is a 
count of the significant characters in the 
IVB. 


Besides holding character-string values, 
IVBs are used in many places by the 
compile-time processor to hold information 
which must be chained from a dictionary 
entry and which is of indefinite length. 
These uses are noted elsewhere. 


Instruction Codes for the Compile-time 
processor 


Compile-time statements are handled in two 
parts. During Phase BC, each statement is 
recognized and syntax checked. An encoded 
form of the statement is then placed into 
the current text block. During Phase BG 
these encoded statements are executed by an 
interpreter. 


All expressions are encoded in postfix 


Polish. A stack is used during Phase II to 
hold all operands. Conversions are done in 
Phase BG. 


Thus the expression (A+B)[|C, for 
example, is turned into 


AB+C]| 


To be more explicit, it is turned into the 
instructions 


PUSH A; 
PUSH B 
ADD; 

PUSH C3 
CONCAT 


The PUSH operator pushes its operand 
onto the phase II stack. This stack 
consists of 150 full words in scratch 
storage. The first byte of each call is a 
Status byte; the last three bytes hold the 
value if the item is FIXED, a pointer if 
the item is CHARACTER or BIT, or an 
indirect reference to a dictionary entry if 
the indirect bit is on. 
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5 
0 |---->[cD/////_ «|: 10000001]? | 
4. 


Low oe See eh oe 4 


The bits of the status byte have the 
following meaning if set to one: 


BIT MEANING 


0 FIXED 

1 CHARACTER 

2 BIT 

3 Indirect reference (i.e., points 
to a dictionary entry) 

4 Character string value does not 


“belong” to the stack and should 
not be erased when stack is 
popped. (Shared with Phase BG 
scan.) 


Bits 6-8 are unused by the interpreter. 
They are reserved for Phase BG scan. 


All instructions generated by the Phase 
BC code generators begin with an operation 
byte. Depending on the operation, it may 
be followed by zero or more bytes of 
information which are intrinsically part of 
the instruction. Each instruction may have 
either or both of the characteristics STACK 
and FIXED. The definition of these 
characteristics follows: 


1. STACK. These instructions consist 
only of the one-byte operator. They 
take their operands, if any, from the 
Phase II stack. These operators 
correspond in general to the PL/I 
arithmetic and string operators. 
Depending on whether they are unary or 
binary, they use the top one or two 
items on the stack. Before these 
operands are used, they are converted, 
if necessary, in place to the required 
type. After the items are used they 
are popped from the stack. The result 
of the operation is pushed onto the 
stack. 


The conversion, the popping, and the 
pushing are all implied for a stack 
operator. 


2. FIXED LENGTH. These operations are 
followed by a fixed number of bytes -- 
usually two. These bytes, which 
usually refer to a dictionary entry, 
serve as the operand(s) of the 
instruction. 


The table below shows the operations 
that are to encode macro instructions. The 
operand description indicates only the 
general operand type for a variable-length 
item. The count byte is omitted. 


a a a a aoe Qe ea — ee oe re ee wee ew ae <= eS -——— a aa a ct ea | 


[MNEMONIC] TYPE | OPERAND DESCRIPTION | FUNCTION | 
{apD | STACK |BINARY; OPERANDS, RESULT FIXED {avB OO 
Lae STACK aeaane: OPERANDS, RESULT FIXED ae | 
ati ! STACK |BINARY; OPERANDS, RESULT FIXED rer i 
ee STACK ‘ aaey) OPERANDS, RESULT FIXED |A/B | 
poner ! STACK cay OPERAND, RESULT FIXED o -B 
canis ! STACK uaaay: OPERAND, RESULT FIXED ie 
pasion ! STACK pa ode B CONVERTED TO TYPE OF A i =B (assignment) 
| | FIXED | | | 
| | | | 
| NOT | STACK |UNARY; OPERAND, RESULT BIT [4B | 
aa ! STACK ere OPERANDS, RESULT BIT ie ' 
ton | STACK Lacan? OPERANDS, RESULT BIT ne 
| CONCAT STACK ee OPERANDS, RESULT CHAR ae 
leone STACK cee OPERANDS, RESULT VARY eee (equality) 
foe STACK aiRARy) OPERANDS, RESULT VARY ass 
ie STACK i arwane: OPERANDS, RESULT VARY nes | 
| INC ! FIXED iawecines aietionaey reference aweaee A ! 
oe ! FIXED \onaswete code re ABORT processing | 
rena | FIXED reine dictionary reference i Transfer to label ! 
ane FIXED inoue dictionary reference ae es to label ! 
eae STACK lees dictionary reference {Transfer to label 
| | FIXED | Jif top of stack false. | 
ar STACK laowecuees dictionary reference and {Invokes the procedure 
| | FIXED |a one-byte argument count | | 
auars FIXED is two-byte dictionary references iaauske: out of INCLUDE | 
Ue FIXED |Two-byte dictionary reference or A onto stack 
pagal ! FIXED ieee dictionary reference ‘een address of A 
| | | Jonto stack | 
oe FIXED fe Three-byte line count sue line count into LINCNT | 
ee FIXED ! no operand jEnter interpreter 
— FIXED ‘A operand . peers to Phase II scan | 
ieee ! FIXED ine o-byte dictionary references Ponce A 
‘Bee FIXED ie o-byte dictionary references  DEACTEVAGE A | 
ioe FIXED | a ictionary reference \oEerARE A 
ED FIXED iptebisieee reference iWo-bee the DECLARE, once 
| | | executed | 
ac a a a a a at naib epar md 
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| 
! 
| 
4 
! 
| 
| 
4 


- i ara aleida main ase en antares oc arias maaan 1 
{MNEMONIC| TYPE {| OPERAND DESCRIPTION FUNCTION | 
j—~--—----}-------} ~~ -------------------------- e—---}+--------------------------- { 
|cvreé |] FIXED |Dictionary reference {Convert to RETURNS 
| | { jattribute 

{ 
| RETN7 | FIXED |Dictionary reference . [Return from procedure A 


{2The ASSIGN operator does not push a result. The expression result is found on 
| the PDS and is popped; the dictionary reference for the left hand side is the 
| single argument. 


| 
|2Operand conversion for EQU, GT, and LT is as specified in IBM System/360 
| Operating System: PL/I Language Specifications. 


|2The TRAF uses and pops the top operand on the stack. It is treated as a bit 
string for conditional transfers. 


“This handles GOTOs out of included text. At this point CLNUP is performed. The 
arguments are (a) the dictionary entry for the label to which control is to pass 
and (b) the dictionary entry for the current INCLUDE. 


| 
| 
| 
| 
| 
|The arguments for the invocation are contained on the stack. The dictionary 
| reference is to the procedure entry. 
| 
| 
I 
| 
| 
| 


6This converts the top of the stack to the attributes specified in the RETURNS 
attribute for the procedure A. 


7This terminates the invocation of procedure A and converts the value on the top 
of the stack to the attribute specified on the PROCEDURE statement. 


ee es eee SE ED AE ce ES eS AD EGS SS NE CS SS ee ue ee ee ees ee eee ees ee SE ee 
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2. COMMUNICATIONS REGION USE 





The region from offset 0 to offset 304 
(ZCOMM) is used as a general communications 
region throughout the compiler, including 


the compile-time processor. The region 
from ZCOMM to ZCOMM4#463 is also used by the 
compiler; however, during the compile-time 
processor phase, this region is used 
exclusively by the compile-time processing. 
The details of this usage are shown below. 


Appendix J: Compile-time Processor 479 





| | Dec. | 

| Name | Offset | Length| Contents | 
fr a nn fn aan an nn a nn nnn enn 
[STATUS |ZCOMM | 1 | Byte 1: Bit 0 not used : 
| | | | 1 PROCSW -- processing macro procedure | 
| | | | Note: 2 FINDBIT -- SRHDIC has found dictionary item | 
| | | | Condition 3 ERSW -- diagnostic produced in Phase II | 
| | | | Settings 4 EFSW -- end of file encountered (input) | 
| | | | "1" = set 5 LEVBIT -- processing IVB | 
| | | | "0" = off 6 INCSW -- processing included text | 
| | | | 7 PH2SW -- in Phase II | 
| | | | | 
J oTA2 {| ZCOMM+1 | 1 | Byte 2: Bit 0 OLDINC -- processing already listed INCLUDE | 
| | | | 1 SKPSW -- indicates entry to END from PRCSCN | 
| | | | 2 NOPERCENTSW -- look ahead for % completed | 
{ | | { 3 SYSOPN -- SYSLIB DCB is open | 
| | | | 4 MACRO -- indicates current macro action | 
| | ; | | 5 PR2SW -- indicates in macro procedure | 
| | | | 7 ARG -- indicates that Phase II is looking for| 
| | | | arguments of activated procedure | 
| | | | | | 
| SUBSTRDR | ZCOMM+2_—s| 2 | Holds dictionary reference of 0 level SUBSTR entry | 
| | | | | 
|TOKPTR |ZCOMM+4 | 4 | Address of character being scanned, text reference or | 
| { | | absolute, right justified | 
| { | | | 
[| INCPTR |ZCOMM+8 = | 4 | Save area for TOKPTR | 
| | | | | 
| INB | ZCOMM+12 | 4 | Absolute address of input buffer, right justified | 
| | | | 
|OUTBUF {| ZCOMM+16 | 4 | Absolute address of output buffer, right justified | 
| | i i | 
|PDSPTR |ZCOMM+20 | 4 | Absolute address to top of pushdown stack, right justified | 
| | | | | 
JENDSUF | ZCOMM+24 - | 4 | Absolute address to last significant character in input | 
| | | | buffer, right justified | 
| | | | 1 
| WHERE | ZCOMM+ 28 | 4 | Address of next available byte in output buffer, text | 
| | | | reference or absolute, right justified | 
| | | | | 
|IVBPTR | ZCOMM+32 | 4 | Text reference to next free IVB, right justified | 
| | | | | 
[LINCNT [| ZCOMM+36 | 4 | Holds current line number, right justified | 
| | | | | 
|TEMPTR [ZCOMM+t40 | 2 | Dictionary reference to top of “*in-use" temporary stack | 
| | I I | | 
|DCENTY |ZCOMM+42 | 2 | Dictionary reference for chaining dictionary items | 
| | { | | 
|CURINC | ZCOMM+44 | 2 | Dictionary reference to INCLUDE entry being processed | 
| | | | 
| CURD | ZCOMM+46 | 2 | Dictionary reference to DO entry being processed | 
| | | | | 
|EROCNO |ZCOMM+48 | 1 | Current procedure number, right justified | 
| | I | | 
| NXTPC | ZCOMM+49 | 1 | Next available procedure number, right justified | 
| | | | | 
|DPHCNT [|ZCOMM+50 | 2 {| Current depth count | 
| | | | | 
| CODE | ZCOMM+52 | 1 | Code for token type | 
{ | | | [ 
[LENGTH |ZCOMM+54 | 2 | Number of signifiant characters in TOKBUF, right justified | 
a a 3 
|MXDPTH | ZCOMM+56 | 2 | Integer value of depth of replacement, right justified | 
| | | | 
| INDEX ree | 2 | Hash table index for dictionary routines | 
beim tee Ree oe a a a ea ee ae | 


fr------- 


| Name 
|ATTR 
ee 
orate 
want 
leavin 
auraae 
ae 
| OUTIVB 
‘BER 


| 
| INVBAB 


—4 


Dec. 
| Offset 


| ZCOMM+ 60 
| 
| ZCOMM+ 64 
| 
| ZCOMM+ 68 


| 
| ZCOMM+ 72 


laccuneao 
geomet 
secnwee 
rey 


| 
| ZCOMM+ 88 


| | 
| OUTIVBAB | ZCOMM+ 92 
| 


| TXTBLKAB | ZCOMM+ 96 


T 
| 
| 
+ 
| 
| 
| 
| 
| 
| 
| 

| | 

| ZCOMM+76 | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


| 
| ZCOMM+ 100 | 


|MTABC 

oe iccmeniOG, 
on ‘cous i0e 
Sor? eccuaaiiel 
ae ere 
Seance ereert 
|MAXLCT eae 
lonesdas | soiah abe 


| DCEMeeyan aCCuMeT oa 
eae eereey? 
eeoeen ‘ sccuaea ahi 
| OUTERCL ecoueeaeal 
Tenceeton ccumncustt 
SOrheide (acon ee 


l | 
|DECIDR | ZCOMM+148] 


| | | 

|CURPRC | ZCOMM+152| 
| 

{|TOKBUF | ZCOMM+164 | 

tL. ee 


2 


rT) 


rT 


De a pee 


ee ee ee ee ee ee re ee er rt es oe oe 0 re me we ow ee ee we we we oe ee ee ne a we a i we ee 


"Type" byte for dictionary routines 


Save area for GRG 


Pointer to IVB chain to be freed or obtained 


Type and value/value pointer for dictionary entries 


Pointer to header information for INBUF 


Pointer to left margin in INBUF 


Current busy block n 


Current busy block n 


Current busy block n 


Current block used i 


Current block used i 


Current block used i 


Address of translate table for 


Length of text block adjusted for chain address 


umber 
umber 


umber 


n absolute address calculation 
n absolute address calculation 


n absolute address calculation 


Pointer to first INCLUDE buffer 


Pointer to second INCLUDE buffer 


Pointer to DCB for SYSLIB data set 


Pointer to DCB for user data sets 


Maximum line count used so far 


Pointer to next byte in which to put procedure text 


Absolute address of dictionary entry 


Pointer to level 1 SUBSTR entry 


Dictionary: 


Dictionary 
Dictionary 
Dictionary 
Dictionary 


Pointer to 


32-byte buffer, characters inserted left justified 


reference 
reference 
referer.ce 
reference 


reference 


current procedure entry on PDS 


of procedure check list 


of outer check list 
for PROCCL cell 


for OUTERCL cell 


of dictionary entry for DECIMAL 1 


TOKSCN and FINDPC 


I 
a ee ee ee ee ee ce ee eee mee ee ene ce ee cree ne cee cen ce ees men cm ce ee came ene em ek ee re cee en ce wee ee ee me ee ce ee ee ee ae ee ee ee ee nh ee ee 


| 
| 
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| 
! 
! 
| 
! 
! 
! 
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! 
| 
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| 
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a CECE SS ESS NARA a a a aa da aig | 


| | Dec. | i | 
| Name | Offset | Length| Contents | 
 Sapuralatanesen Supepseer pppoe. Sana o-esnet Sabo aPGeauearsnepenmanereeee eeeneenstanabasaneiatanmanaanenierenmremmerceenemeeeremmeneeeets 
| HASTB | ZCOMM+300|[ 128 | 64 two-byte dictionary references to hash chains for named | 
{ | | | items | 
1. | | 
|CONSCH | ZCOMM+428 | 2 | Dictionary reference to constant chain ! 
| 
[Srecce [commen 01. 2 | Dictionary reference to special chain -- debugging only 
cs ca tee ate aa eee a ee eae pe ee eee ee eee 
3. COMPILE-TIME PROCESSOR, OPERATING ZTV 
SYSTEM, AND COMPILER CONTROL INTERFACES 
ZMYNAM 
Although the compile-time processor makes 
considerable use of the Operating System MCSIZE 
facilities, it usually does so indirectly 
through the compiler control. However, CCCODE 
those Operating System services required to 
support the INCLUDE facility are invoked TXTSZ 
directly. Since included text is required 
to be a member of a partitioned data set, ZSOR -- column number in which to begin 
it is those data management facilities scan of input text 
which support BPAM which are used. 
Specifically the macros OPEN, FIND, CLOSE, ZMAG ~- column number in which to end 
READ and CHECK are used by various parts of scan of input text 
the INCLUDE handler. Details of these 
Macros can be found in IBM System/360 ZTRAN1 
Operating System, Supervisor and Data | 
Management Services. The following compiler control routines 
are referenced: 
The root phase is invoked by the ZUPL RELESE 
compiler control if the MACRO option is 
specified. All subsequent communication ZURD RLSCTL 
between the compile-time phases and the 
compiler control is done by way of cells in ZUGC ZTXTRF 
the communications region. This includes 
the parameters passed to the F service ZUTXTC ZTXTAB 
routines, the decoded options which are 
tested, and the cells set to indicate the ZURC ZCHAIN 
status of source margins and mode (EBCDIC) 
of the output. ZABORT ZALTER 
Specifically, the following cells in the ZLOADW ZDABRF 
communications region are either used or 
sets ZDICRF ZEND 
PAR1 ZUERR ZUBW 
PAR2 ZDRFAB 
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APPENDIX K: TABLE HANDLING ROUTINES FOR K PHASES 


The purpose of these routines is to permit 
the user to build, scan and otherwise 
manipulate tables in text blocks without 
any concern for physical block boundaries, 
status of text blocks or maintaining 
pointers to first, last and current table 
entries. The routines also handle text, 
which is assumed to be a special type of 
table. 


The user may: 


1. Define a table by using the IEMKTCA 
macro to set up a TCA (task 
communication area) control block. 

The address of the TCA is always 
passed to a table handling routine and 
identifies the table concerned. Most 
TCAs will be held in the local 
communications region in phase KA. 


2. Add new entries to the end of a table. 
Table entries may be of fixed or 
varying lengths. For fixed length 
entries, the length is held in the TCA 
for the table. For varying length 
entries, the TCA contains information 
enabling the routine to determine the 
length of the entry. Fixed length 
entries may be built in storage and 
moved into the table by the routines, 
or space allocated for an entry by the 
routines and the entry built directly 
into the table. For varying length 
entries, the entry must be built in 
storage and moved into the table by 
the routines. 


3. Scan a table either forwards or 
backwards. The user requests the 
address and text reference of the 
‘next’ table entry. The user may 
position a scan to the start or end of 
a table, or to some intermediate 
point. 


4. Reference individual table entries at 
random. This may be done while a 
sequential scan of the table is being 
performed, and will not affect the 
scan. 


5. Specify that a table is to be deleted. 


6. Specify that entries are to be ‘locked 
in’. This means that the absolute 
address of a table entry will remain 
valid until the entry is explicitly or 
implicitly unlocked, or the table is 
deactivated. (See 7). If an entry is 
not ‘locked in‘, any subsequent call 
to the table handling routines may 


render the absolute address returned 
for the entry invalid. The current 
entry of a sequential scan, either 
creating or reading, is automatically 
"locked in‘. 


A randomly referenced entry is only 
locked by an explicit lock request. 


A current scan entry may be unlocked 
explicitly by deactivating the table, 
Or implicitly by making or requesting 
the next entry, Or repositioning the 
scan. 


A random entry may be explicitly 
unlocked, or implicitly unlocked by 
another random reference to the same 
table specifying lock. 


All locks are released when a table is 
deactivated. The total number of 
locked entries for all tables must not 
exceed four at any one time. 


7. Activate or deactivate a table. All 
tables are initially deactivated. 
Tables are always activated 
implicitly, initially by a request to 
add an entry to the table, and 
subsequently by any valid request for 
an operation to be performed on that 
table. 


A table may be deactivated by an 
explicit request. Deactivation causes 
all locked entries to be unlocked, and 
renders all absolute addresses of 
entries in that table invalid. 
Sequential scans are not otherwise 
affected. 


A table is implicitly deactivated by a 
request to free the table (as in 5), 
or if the table contains no locked 
entries and any call is made to the 
table handling routines. 


DESCRIPTION AND FORMAT OF 
MACRO- INSTRUCTIONS 


The IEMETCA Macro 


This macro is used to set up a TCA (table 
control area) control block describing a 
table to be processed by the table handling 
routines. The macro has two functions: 


Appendix K: Table Handling Routines for K Phases 483 


1. Sets up global variables describing set up by a IEMKTCA macro instruction 
tables which are used by the IEMKTAB with the R operand. 
macro to generate appropriate linkages 
to the table handling routines. 


Format: 
2. Used with the R operand to set up a (F) 
TCA control block the address of which table identifier IEMKTCA [,R,]ET=(V) 
is passed to the table handling (T) 
routines to identify the table. The (,L=entry length] (,oPps=(S) (R]) 
‘table identifier’ is the same as the 
‘table2 identifier’ used in IEMKTAB 
macro instructions. It must also be {,NPTRS=no of scan pointers.) 
the label of a fullword containing, at {(,DLF=displacement to length field] 
execution time, the address of the TCA 
Description of Parameters 
Ge ere ee a ee ee ee ee Se re eee ee 1 
| Parameter ! Description | 
jaa - nn nnn nnn nnn nn nnn nn nnn nnn nnn nnn nnn nnn nn nnn nna 
|ET=entry type | This parameter indicates the type of entry contained in the table, as | 


follows: 


| 

| 

{| F - fixed length entries 

| V - variable length entries 
| 


4 


- text 


L=entry length| This parameter is required if ET=F is coded, and indicates the length | 
| of an entry. | 


he ame eee eee ee oo 


~-------------}------------------------------------=---------------------------—------] 


| 
; 
[OPS=operations| This parameter indicates the type of operations to be performed on the | 
| | table, as follows: | 
| | | 
| {| s - sequential scans will be performed | 
| | R - random references will be made | 
~-------~-----}---------------------------------------- -- —- === === === - === === === 
| NPTRS=n This parameter permits more than one sequential scan of one table to be| 
made at one time. ‘n‘* indicates the maximum number of sequential scans| 
which will be in progress at any one time. An individual scan is | 
identified by coding PTR=n in the SET, SETZ or SCAN operation (see | 
IEMKTAB) macro). The default value is n=1 if OPS=S or RS is coded, or | 
OPS is omitted, otherwise n=0. If ET=T is coded, this parameter must | 
be omitted and only one scan is permitted. | 
~--------—---} -~--—--------------------- ------- = ---- +--+ ----- == 2+ === == = 
| DLF=disp. | This indicates the displacement from the first byte of the entry to | 
{to length the two byte field containing the length of the entry. It must must be| 
| field coded if ET=V is coded. | 


PP aww ee ee ee 


| 
! 
{R | This parameter is supplied only if actual code is to be generated from | 
| the macro instruction. It provides a label for the TCA which may be | 
{| used in an A type address constant having the label identifier as its | 
| label. | 
4 


484 


Example of use: The IEMKTAB Macro 


TABLE1 DC A(ATAB1) 


This macro specifies operations to be 
TABLE1 DTCA ATAB1,ET=F, L=8, OPS=S performed on a table or tables. 
to be operated on is always specified by 
supplying the address of its TCA. 


Note: the label on the IFMKTCA 
Macro-instruction statement is not 
made the label of any generated 
Statement, so no multiple definition Format: 
will result. Its only use is to 


provide a link between the two macros {label] IEMKTAB code, 


IEMKTCA and IEMKTAB. 


parameters 


Note: ‘code" specifies the type of 
Operation, and the parameters depend 
on this as shown below: 


< 
| Code| Parameters | 


wanna foe nnn nn nnn nnn nnn nnn 
{BLDC | Table Identifier, address of entry skeleton | 
| | (,AATO=] [,SATO=] | 


}-----}----------------------------------------—---—------------ { 
{|BLDT | Table Identifier [,AATO=] [,SATO=] | 
| -----}----------------~---------------------------—------------4 
| | (N) | 
| DR | Table Identifier, SA=[,AATO=] [,OPT=(L)] | 
}----- }---—-----~------------------------------------------- { 
{ULDR | (Table Identifier,...) or Table Identifier | 
}---~-4----------------------------------------—---—-----------+4 
{SET | Table Identifier, SA=[,PTR=n] | 
}-----}--------------------~---=-~----------- = --—------ 

| (F) | 
|SEIZ | Table Identifier [,OPT=(B)] [,PTR=n] | 
| -----4}------------------------- - —- ++ =n n= 

| (F) | 
[SCAN | Table Identifier [,AATO=] [,SATO=] [,OPT=(B)] | 
| | (,PTR=n][,ETA=] [, TRTAB=,FBTO=] [,PSATO=] I 
}-----}----------------------------------------—---------------- 4 
|FREE | (Table Identifier,...) or Table Identifier | 
eee ee ae eee oa See ae ee eee eee 
|DEACT| (Table Identifier,...) or Table Identifier | 
a ae oe ae ee renee a ee ee eerie ere eee eee | 
{TEST | Table Identifier, NTA= | 
Romie a a a ee J 


Notes: 


The ‘Table Identifier' operand must 
appear in the label field of a IEMKTCA 
macro-instruction physically preceding the 
IEMKTAR macro-instruction. The last three 
operands of the SCAN operation (TRTAB, 
FBTO, PSATO) only apply to text tables 
ET = T in IEMKTCA). 
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The table. 
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Description of Keyword Parameters 


aa ema iano Se pe a ee ee ee ee ee a eS ee eee 7 
| Keyword | Description 1 
| Parameter | | 
~--------— panna nn nnn nnn nnn nnn nnn nn nnn nn nnn tr nnn nnn nn nnn nena nena 
| AATO | A register designation or address of a fullword in which the returned | 
| | absolute address is to be placed. | 
}----------- Saar UD Un na OUD uP guenp= puesta ou nRDSPSS PaT Sun OREN UNEREDP apuINIE ay paanaeraiabaeeraeren 
| SATO | Address of a three byte field in which the returned symbolic address is to| 
| | be placed. | 
Speman ia fe ea ee a eee ee A ee Ee ne a 4 
[SA | Address of a three byte area containing a symbolic address. | 
ee ots oe ne ee fm ee eee 
| OPT | Options applying to this operation. The option letters may appear in any | 
| | order. | 
Coe ee ee 
| PTR | Specifies the pointer which identifies the current record of the scan. 'n’ 
{ | must not exceed the number specified in the NPTRS parameter of the IEMKTCA| 
| | macro-instruction. C indicates the end of table pointer for creating new | 
| | entries. | 
ee ede ee a 
| ETA | Specifies the address of a routine to be given control when the end of a_ | 
| | table is detected during a sequential scan. | 
ma nn mn fn ana nn nnn nn nn nnn nnn nnn 
| TRTAB | Address of translate table for selective scan. | 
a fr ree = ae > ae a a > a> > oe Oe oe ee Se oe 6 oe ee oe 4 
| FBTO | Location or register in which non-zero function byte from translate | 
| | Operation is to be placed. | 
ES A Se ASS ee A 4+—-—~—-~— mtn a om cer on ee 2 ee ee a Sn re tm re ae OP ES OO an ee DS OE Ee wee nn ne ee ee 
| PSATO | Address of a three byte area into which the symbolic address of the | 
| | previous entry is to be placed. | 
}~-----~--—4 ~~~ ------- = -- == === $= i nnn nnn nnn nnn nnn nnn nnn nnn nnn 
| NTA | Address of routine to receive control if table is null. | 


Li... L.. - e d 


Note: A register designation (absolute expression in parentheses) identifying general 
registers 2-9 may be used in the AATO, SATO, SA, ETA, FBTO, PSATO and NTA operands. 
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Description of Table Handling Operations 


eerie ira Pn aaa a ah ne a a Seas ee ee Ee ee eae ee ne 7 
| Operation | Description | 
~----------}-~-----------~-------------=-------------------- = -----------------------4 
| BLDC | Adds an entry to the end of a table. The entry is built in storage by the| 
| | user and moved to the table by the table handling routines. The routines | 
| | return the symbolic and absolute addresses of the new entry. | 
}-----------}--- --- - —-- - -- -- - nn ee + 
The table handling routines allocate space for a new entry at the end of | 
the specified table, and return the absolute and symbolic addresses of the| 
space. The user builds his entry in the space allocated. This operation | 
can only be specified if ET=F was coded in the IEMKTCA macro-instruction. | 


PP ES OS SS SS EE A ST SE SS ES SAE NY SS CD ORS ES cD SES ST ED SSS ES CS SEED GD SHES SNS EY AEE TS SS SR SE GD GD EN ee SES EE ee ED tee ee CO ED A eee GE OU ee OD ED OO UD ED ES De ee ee 


The absolute address of the entry is returned. 
entry is locked in. | 


unlocked. | 


ee ES cee A lh SE SE EEE EE SD ED OEE SS ED NS ED SE SS SS SEES SU EE AE SEO SES ND SEE SGD GED SUE OED GE AO EE ED OSE Cre SD GD CSO SN SD SEP eet GAS OND Ge OR SRE ees ES aS EP ges DD OS ee ee 


parameter. The next SCAN operation causes the absolute address of this | 

entry to be returned. PTR=n (see SETZ). | 
—-~~~-~~--— 4+ +--+ ---- +--+ + + ee 
| SETZ | The sequential scan is positioned to tbe beginning of the table if the OPT| 
| parameter is omitted or OPT=F is coded, or to the end of the table if | 
| OPT=B is coded. The next SCAN operation returns the absolute address of | 
| the first or last table entry to be returned. The PTR=n parameter | 
| indicates which sequential scan is meant if more than one is in progress | 
| at one time. ‘n' may not exceed the number specified in’ the NPTRS | 
| parameter of the IEMKTCA macro-instruction. PTR=1 is assumed if the | 
| parameter is omitted. OPT=B may not be coded if ET=V or T is coded in the| 
{| IEMKTCA macro-instruction for the table. 
4 
| 


~-------- 


| returned. If a SET or SETZ was the last operation, the next entry is that| 
| pointed to by the SET or SETZ operations. The options F or B indicate: | 
| F a forward scan is required. This is the default. | 
| B a backward scan is required. This may only be specified if ET=F is | 
| coded in the IEMKTCA macro-instruction. | 
a oe J 


Selective Scanning Facilitiy 


a a = 7] 


| Code | Description | 

|FREE | One or more tables are completely| 

| | freed and deactivated. The next | 

| | Operation on the table must be a | 

| | BLDC or BLDT. | 
This facility. is available for text tables f-----—- 4 -- - - -—- -- - -- -- - - ee 4 
only (ET=T in IEMKTCA macro-instruction). |DEACT | The table or tables are | 
The TRTAB operand identifies a 256 byte | | deactivated. All locked entries | 
translate table which is used to translate | {| are unblocked and all absolute | 
the code byte of the entry. If the result | | addresses of entries rendered | 
is zero, the scan continues until the | | invalid. | 
routine exits to the ETA address. If the -}----. -—}--------------------------------—-- 
result is non-zero, it is placed in the |TEST | Tests for a null table. If table| 
register or location identified by the FBTO | { is null, control is passed to | 
operand, and control returns to the user, | {| routine identified by NTA | 
the AATO and SATO operands identifying the | | pointer. | 
selected entry. t. -—-——— d-————-—-— — —- —— -4 
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APPENDIX L: CONTROL ROUTINES 


Entry to the various compiler control 


routines is via a transfer vector. 


of the transfer vector appear below. 


ee eee a ae ee a nny 
jHex. | | eee | 
JOffset| Name | Description . | 
}--==--4--—---- $---—-----=-------------- 1 
| 8 | ZUPL | Print a line | 
| | | | 
| c | ZURD | Read a card | 
| | | | : | 
{ 10 | zuGcC | Get scratch storage | 
| | | | 
{| 14 | zuTxTc | Get text block | 
| | | | 
| 18 | zuRC | Release scratch storage | 
| | | | 
{| 20 | ZABORT | Dump and go to error | 
| go | | message routines | 
| { | | 
{| 24 | ZLOADW | Load and return to | 
| | | caller | 
| | | — | 
} 28 | ZDICAB | Make dictionary entry. | 
| | | Absolute address | 
| | | returned | 
| { | | 
| 2C | ZDICRF | Make dictionary entry. | 
{ | | Dictionary reference | 
| | | returned | 
| | | | 
{ 30 | ZUERR | Make error message entry| 
| | | | 
{| 34 | ZDRFAB | Convert dictionary | 
| | | reference to absolute { 
| | | address | 
| | | | 
| 38 | ZLOADX | Load with overlay and | 
| | | return to caller | 
| { | | 
| 40 | REQUEST| Give a list of phase | 
| | {| names required or not | 
| | | wanted for this | 
| { | compilation | 
| | | | 
| 44 | RELESE | Release all named phases| 
| | | | 
{| 48 | RLSCTL | Release all named phases| 
| | | and pass to next phase | 
| | | ; | 
| 4c | ZDUMP | Dump specified main | 
| | | storage and continue | 
bans a Dee gehne een eee eee eee ee eines 4 
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Details 


58 
5C 


. 60 


64 


68. 


6c 
70 
74 
78 


80 


84 


88 


8C 


ey tae et oe 

| 

Name | Description | 

-=------ ¢-=--=---=-==-------------| 

ZTXTRF | Converts absolute | 

| address to text | 

| reference | 

| | 

ZTXTAB | Convert text reference | 

| to absolute address | 

| 7 { 

ZCHAIN | Find next block in chain| 
| 

ZALTER | Change text block status| 
| 

ZDABRF | Convert absolute address | 

| to dictionary reference | 

| . { 

ZNALRF | Make unaligned | 

| dictionary entry. | 

| Reference returned | 

| | 

ZNALDB | Make unaligned | 

| dictionary entry. | 

‘| Absolute address | 

| returned | 

| | 

ZEND | Terminate job | 

oe | 

ZULF | Write on load file | 

| . | 

ZUSP | Write on punch | 

| | 

ZUBW | Write on auxiliary | 

| storage | 

[ | 

RLSCTLX| Release all named phases| 

| and hand control to the | 

| next phase, after having| 

{| loaded it with overlay | 

| | 

RECONS | Reconstitute | 

| instructions in IEMAL | 

| | 

DYNAMIC| Pass control to the | 

| dynamic dump routines, | 

| if required | 

| | 

IEMAL/ | Address of second | 

IEMAN | control phase | 

Séceecie De Se a ecm meee mama 


COMPILER CONTROL ROUTINES 


aaa eteuirataa oe ee se ee ee ee te ee ee ee ee ee Se ee ee ee “1 

| Name |Hex. | Details | 

| | Offset | | 
~~~---~--}------4~----------- —- +--+ - +--+ +--+ - + - = + e+ 
RELESE 44 Description 


Deletes list of phases 
Parameters Passed 


| 
| 
| 
| 
| 
| PAR1i byte 0 unused 

| 1-3 address of list of phases to be deleted. The list of 
| phase names, each of two characters, is 

| terminated by the name 22 

| 

| 

| 

| 

+ 


Parameters Returned 


ee eed 





| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| None 
 caemigieameeeas Se 
| REQEST | 40 | Description | 
| | | | 
| | | Marks phases as ‘wanted’ or ‘not wanted’ | 
| | | | 
| | | Parameters Passed | 
| | | PAR1 byte 0 unused | 
| | | 1-3 address of list of phases to be marked as ‘wanted’ | 
| | | | 
| | | PAR2 byte 0 unused | 
| | | 1-3 address of list of phases to be marked as | 
| | | "not wanted‘ | 
| | | | 
| | | Parameters Returned | 
| | | | 
| | | None | 
{ | | | 
| | | Notes | 
| | { | 
| | | A phase list containing only '2Z' is effectively a null list. | 
| | | During module AM phases of the compiler are all marked as either | 
| | | normally loaded or not loaded. A phase which is normally not loaded| 
| | | is only loaded if it has previously been marked as ‘wanted*. A | 
| | | phase which is normally loaded will always be loaded unless it has | 
| | | previously been marked as ‘not wanted’ | 
ieee ee J 
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| Name |Hex. | aR AR a a a arora or rat | 








Name |Hex. | Details { 
| {Offset | [ 
}-------- ED aes VES pe Ge ee 2S LS LS A SS SS SS SS SS ST LD SS AAD SS SD SD SD ED Sy SA GE ED AD GD SS EAD SS SD A SR UD Ges ee OS ee ee wee omy Oe ee ee ee oe 
| RLSCTL | 48 | Description | 
| | | ! 
! ! Deletes a list of loaded phases and passes control to next phase | 
{ | | Parameters Passed ! 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1-3 address of list of phases to be deleted before next | 
| | | phase is loaded | 
| | { 
| | | PAR2 byte 0 unused 
| | | 1-3 (a) zero, if next phase is to be taken from compiler | 
| | | control phase directory | 
| | | (b) address of phase name to be loaded next | 
| | { | 
| | | Parameters Returned (to next phase) | 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1-3 address of new phase load point | 
| I | | 
| | | Notes | 
| i | | 
| | | List of phases given by the address in PAR1 is deleted. Then the | 
| | | next phase is selected and loaded and control is passed to a point | 
| | | two bytes from the load point of the new phase | 
pean n=} ann fn nn nnn nn nn nn en nn nn end 
| RLSCTLX| 80 | Description | 
| | { 
| | | Releases all named phases and passes control to next phase. The | 
| | | next phase may be loaded more than once | 
i | | { 
| { | Parameters Passed | 
| | | | 
| | | PAR1 byte 0 unused | 
{ | | 1-3 address of list of phases to be deleted before next | 
| | | phase is loaded | 
| i | | 
| | | PAR2 byte 0 unused | 
| | | 1-3 (a) zero of next phase is to be taken from compiler | 
| | | control phase directory | 
| | | (b) address of phase to be loaded next | 
| { | | 
{ | | Parameters Returned (to next phase) | 
| | i | 
| | | PAR1 byte 0 unused | 
| | | 1-3 address of load point of new phase | 
| { | | | 
| | | Notes | 
| | | | 
| | | 1. List of phases given by the address in PAR1 is deleted. The | 
| | | next phase is selected and loaded and control is passed to a point | 
| | | two bytes from the load point of the new phase | 
| | | | 
| | | 2. The entry point RLSCTLX does not cause the compiler control | 
| | | routines to advance the pointer in the table of phases still to be | 
| | | loaded, and does not cause the phase to be marked as already loaded | 
| | | once | 
eg a a a a ce J 
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{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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Name 


ZABORT 


Hex. 


| Details 


{Offset | 


ene cee eeere anne qvenan GANS cane EEE SEEN GEES SUE EL LD ER ED SA ON ND SEN SA SRN CE SD GD SS SUD eS ee a a SE A ES ee NS ES QS SS SE SS So 


20 


Description 


Deletes currently loaded phases (after dumping if DP specified in 


parameter) and passes control to Error Fditor 


Parameters Passed 


None 





0 unused 
1 text block number 
2-3 unused 


PAR2 bytes 0-2 unused 
3 status required 
bits 0-3 unused 
4 x'§" "busy' 
5 x'3" "wanted' 
6 X*2'. 'not wanted’ 
7 X‘1° ‘free’ 


Parameters Returned 


PAR2 is unaltered and may be used in successive calls without 


reloading 





1. Terminology: 


"busy' - lock into storage i.e., address preserved 


*Wanted' - information required, do not spill unless necessary 


| 
| 
| 
| 
I 
| 
| 
| 
| 
| 
| 
| 
4 
{ 
| 
| 
| 
| 
| PAR1 byte 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 


"Not wanted! ~- information required, block may be spilt 
| "Free' - information no longer required 


we we ee bn ee a ee 
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J 


491 


ace teacaaed meade cea DO oP ae ae et ee pee eg he Ty ape et ee ae ne a eS a 7 
{| Name |dex. | Details { 
| JOFfset | | 
}-——--~—~ }----— fran anno nnn nn nnn nnn nn nnn nn nnn nnn nn nnn nnn nnn nnn ne { 
| ZCHAIN | 58 | Description | 
| | | 

| | | Finds next text block in chain | 
| | | 

{ | | Parameters Passed | 
| | | | 
| | | PAR1 byte 0 unused | 
| | ( 1 current block number | 
| | | 2-3 unused { 
{ | | | 
| | i PAR2 bytes 0-2 unused | 
| | | 3 status required for old block | 
| | I | 
| | | Parameters Returned { 
I | | | 
{ | | PAR1 byte 0 unused | 
| | | 1-3 text reference of start of new bplock | 
| | | | 
| | | PAR2 byte 0 unused | 
| | | 1-3 absolute address of start of new block { 
| | | | 
| | | Note | 
1 | | ; | 
{ | | The new text block is marked as busy | 
}-------- }—--—- fanaa na nr a nn nn : 
| ZDABRF | 60 j Description { 
[ [ | | 
{ | | Converts absolute address to dictionary reference | 
{ | | | 
I | | Parameters Passed { 
| | | | 
{ | | PARI bytes 0-1 unused | 
{ | | 2-3 any reference in the same dictionary block | 
{ | | | 
| | | PAR2 byte 0 unused i 
| | | 1-3 absolute address to be converted | 
{ | | | 
| | | Parameters Returned | 
| | | 
| | | PARL bytes 0-1 unused | 
| | | 2-3 dictionary reference corresponding to absolute | 
| | | address | 
| | | | 
| | | Wotes | 
| | | | 
| | | 1. No check is made that this address is the start of a dictionary | 
| | | entry, or that it is any other specific point | 
| | | | 
| | | 2. No check is made that the address is in the same block as the | 
| | { dictionary reference passed. If this is the case, that is, the | 
| | | parameters passed are in error, the dictionary reference returned | 
| | | may not correspond to the address | 
tee Ms iceace Gi ee ee le eee ee ee ee J 
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ZDICAB 


offset 
4+ Siw Get et os 
| 28 
| 
| 
| 
| 
| 
| 
| 
\ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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| 2¢ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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| 
| 
| 
| 
| 
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Description 
Makes aligned dictionary entry and returns absolute address 
Parameters Passed 


PAR1 byte 0 unused 
1-3 address of entry (as built by calling phese) 


PAR2 bytes 0-1 unused 
2-3 length of entry (binary) 


Parameters Returned 


PAR1 byte 0 unused 
1-3 dictionary entry address 


PARY bytes 0-1 unused 


2-3 reference to some point in the same dictionary block 


Notes 


1. The entry built is constructed complete with code byte and 
length fields. The length passed in PAR2 is the lenath of the 
complete entry 


2. ZDICRF performs the same function and returns more information, 


with no loss in efficiency 


Description 


Makes an aligned dictionary entry and returns its dictionary 
reference and absolute address 


Parameters Passed 


PARI pyte 0O unused 
1-3 address of entry 


PAR2 pytes 0-1 unused 
2-3 length of entry (binary) 


Parameters Returned 


PAR1 bytes 0-1 unused 
2-3 dictionary reference of entry 


PARY pyte OO unused : 
1-3 dictionary entry address 


Notes 


See ZDICAB 


Appendix L: Control Routines 
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c 
| Name 


| ZDRFAB 


ZDUMP 
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| tiex. 
JOffset 
34 
4c | 
| 
| 
| 
| 
| 
| 
| 
i 
\ 
| 
| 
| 
| 
| 
| 
| 
\ 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
l 
| 
| 
—<——- + 
6c | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
Speed oe 


Details 


Description. 
Converts dictionary reference to absolute address 
Parameters Passed 


PAR1 bytes 0-1 unused 
2-3 cictionary reference 


Parameters Returned 


PAR1 byte 0 unused 
1-3 adsolute address 


Description 
Dumps specified storage and continues 
Parameters Passed 


PARL byte O x'0O! 
1-3 unused 


PAR3 bytes 0-3 either (a) zero 
or (b) address of a page heading to he 


Parameters Returned 
None 


Notes 


a a a a 


orinted 


1. The areas to be dumped, anda the editing to be aone on them, is 


given in the DUMP parameter to the compilation 


2. The dume is only produced if the two character name in ZMYNAM 
matches one of the phase names specified in the DUMP parameter 


3. The message "PHASE zz COMPLETED" is printed if 'P* is included 
in the DUMP parameter even thoucgth control is returned to the point 


of invocation in the phase 


4, The registers printed by the dump routine are not necessarily as 


wnen control was passed from the callina phase 
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Descrintion 





Terminates compilation immediately 
Parameters Passed 
None 


Parameters Returned 


ne ee 


. 
{ Name |xHex. | Details | 
| |Offset | | 
fan na nnn fn nf nnn nn nn nn nn nnn nnn nnn nnn nn nnn nnn nnn nnn nn enn nnn nana nnn 
| ZLOADW | 24 | Description | 
| | | 
| | | Loads phase and returns control to calling phase | 
{ | | | 
| | | Parameters Passed | 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1-3 address of name of phase to be loaded | 
| | \ | 
| | | Parameters Returned | 
| | | | 
i | | PAR1 byte 0O unused | 
| | | 1-3 address of phase load point | 
| | | | | 
| | | Notes | 
| | | | 
| | | 1. Control is returned to calling phase, not to phase just loaded | 
| | | | 
| | | 2. Tne entry point ZLOADW causes the phase loaded to be marked as | 
| | | such, and therefore cannot be loaded again (see ZLOADX) | 
}-----~-- $------ fran nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn : 
| zioabx | 38 | Description | 
| | | | 
| | | Loads phase and control is returned to calling phase | 
| | | . | 
| | | Parameters Passed | 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1-3 address of name of phase to be loaded | 
| | | | 
| | | Parameters Returned | 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1-3 address of phase load point | 
| | | | 
| | | Notes | 
| | | | 
| | | 1. Control is returned to calling phase, not to phase loaded | 
{ | | | 
| | | 2. The phase loaded may be loaded again, since it is not marked as | 
| | | loaded by this entry point (see ZLOADW) | 
bee oes i ene OE a oe rt cet a a se a ee eames 
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T 
| Name j#ex. | Details | 
| {Offset | { 
}-------- }------ fern nn nnn nn nn nnn nnn nnn nnn nnn nnn nn nnn n-ne { 
| ZNALAB 68 Description | 
| | 
| Makes unaligned dictionary entry and returns absolute address | 
| | 
| Parameters Passed | 
{ | 
| PAR1 byte 0 unused | 
| 1-3 address of entry | 
| | 
| PAR2 bytes 0-1 unused | 
| 2-3 length of entry (binary) | 
{ | 
| Parameters Returned | 
| | 
| PAR1 byte 0 unused | 
| 1-3 dictionary entry address | 
| | | 
| PAR4Y bytes 0-1 unused | 
{ 2-3 reference to some point in the same dictionary block | 
| | 
| Notes | 
| | 
| 1. The entry is constructed exactly as it will appear in the | 
| dictionary, complete with code byte and length field | 
| | 
| 2. ZNALRF per forms the same function and returns more information, | 
| | 
pom nm fn nnn fn nn nn a nnn nnn nnn nnn { 
ZNALRF 64 Description 


Makes unaligned dictionary entry and returns its mace onaty 
reference and absolute address 


Parameters Passed 


PAR1 byte 0 unused 
1-3 address of entry 


PAR2 bytes 0-1 unused 
2-3 length of entry (binary) 


Parameters Returned 


PAR1 bytes 0-1 unused 
2-3 dictionary reference of entry | 


PAR4& bytes 0 unused 
1-3 dictionary entry address 


Notes 





| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
I 
I 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| with no loss in efficiency 
4 
| 
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| 
| 
| 
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| | 1. See ZNALAB 
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rere a A aa aa a aa a ER aa a a in a a ce | 
| Wame |kRex. | Details | 
| {Offset | | 
}-------- }----—- }---—--~------~------------ +--+ == == === == += === 2-22-22 - == === - i 
| ZTXTAB | 54& | Description | 
| | | | 
| | | Converts text reference to absolute address | 
| | | | 
| | | Parameters Passed | 
| | | | 
| | | PARI byte 0 X*80° if status of block to remain unchanged | 
| | | not X'80" - text block set to busy | 
| | | 1-3 text reference to be converted | 
| | | | 
| | | Parameters Returned | 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1-3 absolute address corresponding to text reference | 
}-------- }------ }------~--------------- === $= === = $$$ 5 === === == { 
| ZTXTRF | 50 | Description | 
| | { | 
| | | Converts absolute address to text reference | 
\ | | | 
| | | Parameters Passed | 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1 block number of text block containing absolute address | 
| | | 2-3 unused | 
| | | | 
| | | PAR2 byte 0 unused | 
| | | 1-3 address to be converted | 
| | | | 
| | | Parameters Returned | 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1-3 text reference corresponding to absolute address | 
| | | | 
| | | Notes | 
| | | ee | 
| | | 1. This routine is of use in only a few cases since it requires to | 
| | | be passed the block number containing the absolute address, and only| 
| | | returns the offset from the start of the block. This offset can be | 
| | | calculated, if the text block is scanned sequentially, by | 
| | i subtracting the address of the start of the block | 
|--------}------ }-------------------------------- ---- --- ----- ---------------------------| 
{| ZUBW | 78 | Description | 
| | \ | 
| | | Writes on backing storage | 
| I | | 
| | | Parameters Passed | 
| | | | | 
| | | PAR1 byte 0 unused | 
| |: | 1-3 address of output record | 
| | | | 
| | | PAR2 bytes 0-1 unused | 
| | | 2-3 length of record (binary) | 
| | | | 
| | | Parameters Returned | 
| | | | 
| | | None | 
buoae eee eae a hh aa ier a ee i ed 
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Inserts diagnostic messages in dictionary 


Parameters Passed 


PAR5 bytes 0-1 unused 
2-3 numeric parameter, if any (halfword binary) 


PAR6 byte 0 unused 
1-2 message number (hexadecimal) 
3 bit 0 on if text to be inserted 
1 on if statement number to be inserted 
2 on if numeric parameter to be inserted 
3 on if dictionary reference to be inserted 
4-7 severity code of message 


X'O' Termination 
X°4&"* Severe 

X'8* Error 

X'C' Warning 


PART either: 
byte 0 unused 
1-3 address of text to be inserted 
1 unused 
3 dictionary reference to be inserted 


or: byte 0- 
2- 
PAR8 bytes 0-1 unused 
2-3 length of text to be inserted 
Parameters Returned 
None 
Notes 
1. When the message is printed the numeric parameter is converted 
to decimal and inserted into the message. PARS is unused if bit 2 
of byte 3 in PAR6 is off 
2. If bit 1 is on, the statement number is taken from the ZSTAT 
slot in the communications region at the time ZUERR is called 
to ZUERR, the routine aborts 


4. IEF bit 3 is on, the dictionary reference from PAR7 is inserted 


the BCD from the dictionary entry, indicated by the reference, and 
insert it into the message 


5. If bit 0 is on, text is picked up from the address given in 
into a message is 10 characters. If the length civen is greater 


tnan 10 the text is truncated to 10 characters. If the text has 
been truncated it is enclosed in quotes in the message 


3. Bits 0 and 3 are mutually exclusive and if both are on ina call 


into the message dictionary entry. The error message phases pick up 


ee | 


PAR7. This text is in compiler internal representation. The length] 
of the text is taken from PAR8. The maximum length of text inserted| 


pa | 


ee eae ee 


Z0GC 


ee ee ee ee cee oe te 
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Details 


Description 

Gets scratch storage 
Parameters Passed 

PAR1 bytes 0-3 count of 512 byte blocks of storage required} 
Parameters Returned 


PAR1 byte 0 unused 
1-3 address of allocated scratch storage 


PAR2 bytes 0-1 unused 
2-3 bytes of storage allocated 


Description 
Writes record to object module file (SYSLIN) 
Parameters Passed 


PAR1 byte 0O unused 


1-3 address of 72 byte area containing record to be 


written 
Parameters Returned 
None 


Notes 


1. Tf an uncorrectable I/O error occurs on this data set the option 
LUAD is switched off, a message is produced, and the compilation 


continues without producing an object module 


2. The last 8 bytes of the record will contain: 
bytes 73-76 name of object module, taken from ZPRNAY“ iin 


communications region. This is set from the first 
four characters of the first entry label of the 


external procedure 
77-80 sequence number 


wee ee ee ee ee ee eee ew one -- - - -- - - -- - 7} 
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se ae eS ite a PTE eV RE FORE ee Le pea te ee age PC Te gee ee era re ger a ee 1 
| Name |Hex. | Details | 
| joFFset| | | 
|-------- }------ brn nnn nnn nn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn | 
| ZUPL | O8 | Description | 
I | | | 
| | | Puts record out to SYSPRINT Data Set | 
| | | | 
| | | Parameters Passed | 
| | | | 
| | | PAR1 byte 0 unused | 
| | | 1-3 address of area defining print line | 
| | | | 
| | | PAR3 bytes 0-3 zero if no secondary heading to pe printed | 
| | | or address of area defining secondary heading line | 
| | | | 
| | | Parameters Returned | 
| | | | 
| | | None | 
| | | | 
| | | Notes | 
| | | ; Sas 1h | 
| | | 1. Paging action is performed automatically | 
| | | | 
{ | | 2. Format of area containing print line is: | 
| | | byte 0 x'N0' | 
| | | 1 total length of area (binary) | 
| | | 2 ASA control character | 
| | | 3 line to be printed-EBCDIC, variable length, maximum 132 | 
| | | characters | 
j-------- {—-—-—— fen aa nnn nn nn nn enn nn nn { 
ZURC {| 18 | Description | 

| | | 

| | Releases scratch storage got by ZUGC | 

| | | 

| | Parameters Passed { 

| | 

{ | PAR1 bytes 0-3 count of entries to ZUGC to be released (binary) | 

| | | 

| | Parameters Returned | 

| \ | 

| | None | 

| | | 

| | Note | 

| | | 

j | The routine frees all the storage that was allocated by the last n_ | 

| | calls to ZUGC, where n is given by PAR1 | 

-------- fan nn nnn nnn nnn rn rn nnn mena ane arend 
ZURD | OC | Description | 

| | 

| | xeads record from SYSIN | 

| | | 

| | Parameters Passed | 

| | | 

| | PARL byte 0 unused | 

i | 1-3 address of area into which record is to be placed | 

| | | 

| | Parameters Returned | 

| 

| | PAR2 bytes 0-1 unused | 

| | 2-3 length of record returned (binar+) | 

a ee nee he to a te ee ee ee er re er ee a a a ee aS 
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Name |Hex. 


jO£ffset 

es et cote es 4——---—}-~----—------+~~---+ +--+ +--+ - +--+ -- - - +++ + ees 
ZUSP | 74 Description 

| 

| Puts record out to SYSPUNCH 

| 

| Parameters Passed 

| 

| PAR1 byte 0 unused 

| 1-3 address of 72 byte area containing record to be 

| written 

| 

| Parameters Returned 

| 

| None 

| 

| Notes 
| 
| 
ZUTXTC | 14 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
eae eee a! 


Details 





1. The relevant option is PUNCH. See ZULF for other notes 


Description 
Gets new text block and optionally chains it to a current block 
Parameters Passed 
PAR1 byte 0 unused 
1-3 text reference to a current block if new one is 
to be chained 
PAR2 bytes 0-2 unused 
3 X*00"* no chaining 
or X'8n' chaining where n is status required for 
current block 
Parameters Returned 


PAR1 byte 0 unused 
1-3 text reference to new block 


PAR2 byte 0 unused ; 
1-3 absolute address of start of new block 


Notes 
1. The new block is set to a status of ‘busy' 


2. See ZALTER for definition of status of blocks 
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Indexes to program logic manuals are consolidated in the publication IBM System/360 


Operating System: Program Logic Manual Master Index, Form Y28-6717. 


For additional 


information about any subject listed below, refer to other publications listed for the 


same subject in the Master Index. 


abbreviations used during 
compilation 439-448 
abnormal termination 23 
absolute addresses, conversion 15 
absolute code, instruction formats 
accumulator register 64 
additions to text 40 
adjustable bounds 34 
ADV (see array dope vector) 
aggregate length table 65 
aggregates logical phase 46 
aggregates, RDV for CONTROLLED or BASED 57 
aliasing, of variables 47 
alignment, by structure processor 46 
ALLOCATE chain 29 
annotated dictionary dump 25 
annotated text dump 25 
AREA 25 
argument markers 52 
arithmetic registers 51 
array bounds 32 
array dope vector (ADV) 39 
array multipliers, calculated in structure 
processor 46 
arrays 
of string dope vectors 46 
of strings, calculations with VARYING 
attribute 46 
assigned registers 67 
ASSIGNMENT triples 59 
ATR option 39 
attribute collection area 35 
scanned for SETS 37 
attribute list, scanned 34 
attributes 
consistency 29 
consistency analyzed 31 
dictionary entries 28 
inconsistent 34 
invalid 34 
syntax checking in read-in phase 31 
test for consistency 32 
when printed 40 
AUTOMATIC chain 38 
housekeeping 39 
in structure processor 46 
scan in psewlo-code phase 51 
VDA 63 
auxiliary storage 17 
spilling 15 


433-434 


base registers 67 

based variable expression (BVEXP) 39 
BASED variables, RDV 57 

batch compilation 26 

BCD, translation 26 

BEGIN statements, count 29 

BLDL 26 


BLDL macro 23 
phase directory construction 386 
block control 21 
block control area 22 
block header chains 33 
block nesting levels 30 
block size 
determination of 15 
dictionary 15 
selection 22 
SIZE option 22 
text 15 
bound slot 39 
boundary alignment, by structure 
processor 46 
build list 23 
phase directory construction 386 
built-in function handler 28 
built-in functions 
EMPTY 42 
generic 33 
non-generic 33 
NULL 4&2 
NULLO 42 
scan for 54 
TRANSLATE 52,277 
VERIFY 53,277 
BUY ASSIGN statements, scan in pseudo-code 
phase 59 
BUY statement 42 
scan in pseudo-code phase 59 
BUY triples, in pseudo-code phase 55 
BVEXP (see based variable expression) 
BXH instruction, used to generate 
pseudo-code 47 
BXLE instruction, used to generate 
pseudo-code 47 
BY NAME option, in pretranslator phase 40 


CALL chain 29 
calling program 21 
cards, control 26.1,86 
catalogued procedures 15 
CCCODE 26 
chains 26 
ALLOCATE 29 
AUTOMATIC 38-39 
housekeeping 39 
in structure processor 46 
scan in pseudo-code phase 51 
VDA region 63 
block header 33 
CALL 29 
circular 33 
COBOL, in preprocessor 46 
constants 38,60-61 
constructed by read-in 29 
CONTROLLED 39 
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in structure processor 46 
DECLARE statements 29,35 
DEFINED scan 47 
error 69 
hash 33 
picture 34 

validity check 38 
PROCEDURE-ENTRY BEGIN 29 
STATIC 39,61 

in structure processor 46 

scan of external section 68 
SUBS TABLE 49 
symbol variables 62 
type 1 entry 68 

chamelon dummy argument 45 
chamelon temporaries 41-42 
character translation 21 
CHAR48 option 24 
check, syntax 26.1,161 
CHECK lists, formal parameters 38 
circular chains 
extended 34 
initialized 33 
cleanup phase 27 
CLOSE statements, parameter list 57 
closing routine 26 
CNvc macro 60 
COBOL chain, mapped in preprocessor 
phase 46 
COBOL option, in ENVIRONMENT string 41 
code byte 
for TASK option 41 
GOOB 37 
GOTO 37 
statement introduction 37 
text string 17 
code . 
for prologues and epilogues 460-465 
library call 46 
compiler completion 23 
Gictionary 26 
comments, removed from input text 29 
common data space 48 
commoning of subscripts 48-49 
communication between phases 17,21 
communication with control program 15 
communications region 
contents 17 
Control Code word 17 
dictionary block 17 
initialization 21 
of dictionary 17 
options 17 
tables 451-457 
use 21 
ZPRNAM 67 
compare action 44 
compare weight 44 


compilation 
as a job step 15 
bypassed 28 


termination 70 

compile-time processor 15 
communications region 479-482 
constants 30 
control interfaces 482 
identifiers 30 
internal formats of text 474-478 
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logical phase 27 
operators 30 
output string 30 
SOURCE option 23 
compiler control 21-26.1 
compiler control modules 21,24-26.1 
compiler control phases, tables 75-86 
compiler control routines 15 
compiler functions, scan in pseudo-code 
phase 59 
compiler logic, guide to 71 
compiler organization and control 
diagram 20 
compiler read routine 28 
compiler 
as part of operating system 15 
completion code 23 
functions 32 
initialization 21 
invocation by calling program 21 
output data sets 15 


phases 15 
pseudo variables 32 
purpose 15 


storage requirements 15 
completion code 23 
concatenation, in 48 character set 27 
consistency of attributes 29 
consistency of options 29 
constant chain 60-61 
constants pool 60 
constants 

chain 38 

contextual use 31 

conversion to binary 37 

count 37 ; 

dictionary entries 28 

in compile-time processor string 30 

marker 37 
contextual 

constants 31 

identifiers 31 

pictures 31 
control — 

diagram 20 

of dictionary block 21 

of text block 21 
control cards 26.1,86 
control blocks 

DECLARE 41 

OPEN 41 
Control Code word 17, 26 
control module 21,24 
control of workspace 15 
control program 15 
control routines 28 

compiler 15 

debugging 15 

diagnostic messages 23 

entry 21 

initialization 15 

input/output 15 

input/output 23 

program interruptions 15 

storage allocation 15 

storage dumping 15 

table Of 488-501 

ZUBW 27 


ZURD 27 
control tables 86 
control variables in pseudo-code phase 52 
CONTROLLED chain 

scan 39 

in structure processor 46 


Index 
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ZONTROLLED variables, RDV 57 
SONV macro 60 
CONV pseudo-code macro 59 
conversion 

absolute addresses 15 

constants to internal form 60 

input characters 28 

symbolic references 15 

of built-in functions 42 

of character codes 30 

.of constants 37 

of precision data 34 

of replication factors 52 

to EBCDIC 28 

to internal code 28 

to triples 44 

48 to 60 character symbols 26.1 
CONVERT pseudo-code macro 60 
correction of syntactical errors 29 
correspondence defining 47 
count stack 37 
count, of constants 37 


Data Element Descriptor (DED) 37 
for symbol variables 62 
data flow diagram 16 
data sets 
compiler output 15 
data flow diagram 16 
INCLUDE 27 
input/output 15 
input/output usage table 24 
interface with compiler phases 23 
opening 21 
SYSIN 15 
SYSLIN 15 
SYSPRINT 15 
SYSPUNCH 15 
SYSUT1 15 
SYSUT3 15 
TRACEOUT 26 
DD statement 15 
debugging 
control routines 15 
features 26 
DECLARE chain 29 
DECLARE control block 41 
DED (see Data Element Descriptor) 


default rules, in dictionary entries 34 


DEFINED chain check 46 

DEFINED chain, scan 47 

DEFINED data 39 

DEFINED items, in aggregates phase 47 
defined references 39 

defined slot 36,39 


defining 
dynamic 39 
static 39 


validity of 39 
detection of syntactical errors 29 
diagnostic message chain 30 
_ diagnostic messages 15 
allocation to phases 466-473 
parameters in dictionary chain 30 
diagnostics 
for invalid characters 28 
syntax errors 28 


dictionary 


accessing 31 

annotated dump 25 
areas 31 

BCD entries 26 

codes 26 
communications region 17 
constant chain 60 
constructing 31 
default rules 34 
diagnostic message chain 30 
diagnostic messages 23 
dump 26 

embryo entry 29 
extended 26 

hash table 31 
identifiers 31 

normal extended 21 
normal size 26 
organization 17 
resident table 384 
search 31 


dictionary block 


as communications region 17 
control 21 

release 28 

size 15 

space allocation 21 


dictionary entries 


attributes 28 

AUTOMATIC chain 38 

code bytes 387 

constants 28 

copy made 36 

data byte 38 

defined data 39 

definition of types 32 

diagram for internal entry point 33 

dimension table 412 

dope vector descriptor 47 

dummy reference 35 

entry points 32 

expanded 39 

for file conditions 38 

for file constants 41 

for ON conditions 37 

for STATIC DSAs 61 

format 17 

formats 
AUTOMATIC chain delimiter 409 
BCD entries 407 
built-in-functions 406-407 
CHECK list 408 
code bytes 397-400 
compiler labels 404 
constants 405-406 
data items 395-396 
DED 410 
DED2 410 
dope vector skeletons 409 
dope vectors for temporaries 410-411 
DVD 411 
ENTRY code byte 393-394 
entry points 389-393 


entry type 1 389-391 
emtry type 2 391 

entry type 3 391-392 
entry type 4 392-393 
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entry type 5 393 
error message 411-412 
EVENT data 406 . 
FED (Format Element Descriptor) 410 
files 405 
formal parameters 404 
GENERIC entry 393 
internal library functions 407 
label BCD entries 410 
label constants 404 
label variables 394-395 
ON condition 408 
ON statements 407-408 
optimization code byte 394 
options code byte 394 
parameter descriptions 407 
parameter lists 409 
Pictures 408-409 
RDV 411 
second code byte 407 
SETS list 392 
STATIC DSA 411 
structure entries 396 
symbol table entries 409 
task identifiers 406 
variable information 400-401 
wprkspace requirements 409 
GENERIC 42 
INITIAL value list 413 
INITIAL values 412-413 
internal formats 387-413 
iterative DO-loops 28 
labels 30 
LIKE referemce 36 
optimization 34 
options code byte 34 
picture table 34 
pictures 38-39 
RDV and DVD 62 
record dope vector 47 
REVERT statements 38 
SIGNAL statements 38 
skeleton dope vector 61 
statement labels 29 
symbol table 62 
Gictionary logical phase 31 
dimensions, inherited 38 
DISPLAY statements, parameter list 56 
DO group stack 52 


DO MAP 
chain 48 
table 48 


DO statements, count 29 

DO-loop control optimization 50 

dope vector descriptor, dictionary 
entry 47,62 

*dope vector required’ bit 39 

dope vector, virtual origin slot 46 
DROP item in pseudo code 51 

DSA (see Dynamic Storage Area) 


DSLOTS 22 
DTSP 25 
DTSPC 25 


dummy arguments 

chamelons 45 

when created 45 
dummy dictionary reference 35 
dummy reference, in second file 38 
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dummy references, in text 37 
DUMP option, effect on SIZE option 25 
dump 
of dictionary 26 
on SYSPRINT 25 
DUMP 
option 25 
parameter 25 
dumping, inter-phase 25 
DVD (see dope vector descriptor) 62 
dynamic defining 39 
dynamic dump 25 
Dynamic Storage Area (DSA) 51 
Optimization 64,464-465 
tasking information 63 


EMPTY built-in function 42 
END card 69 
END statements 

count 29 

inserted 29 
end-of-file indication 29 
end-of-program indication 29 

count 30 
end-of-program marker, in pseudo-code 

phase 54 

entry labels, in source text 29 
entry point, formal parameter 36 
entry points, dictionary entries 32 
entry type 1 68 
ENVIRONMENT option, for file constants 41 
ENVIRONMENT string, with COBOL option 41 
environmental options, use of 15 
EOB (end of block) 
EOB operator 44 
epilogue code, examples 460-465 
erroneous references, replaced in text 37 
error chains 69 
ERROR condition 29 
error dictionary entries 69 
Error Editor 30 
error editor logical phase 69 
error message text 70 
error messages 

Classification 23 

order of severity 28 

phase directory 23 

text 28 
errors and diagnostic messages 29 
errors, detected in read-in phase 31 
ESD (see External Symbol Dictionary) 
EXCLUSIVE second level narker 41 
EXEC STATEMENT 15 
explicitly generated statements, in 

pretranslator phase 40 

expression, definition 42 
expressions 

array bounds 32 

initial value iteration factors 32 

string lengths 32 

structure 43 
extended dictionary 21,26 
external library routines 439 
External Symbol Dictionary 

ESD cards 67 

in data flow diagram 16 


factored attribute table 34 

factored attributes 34 

file conditions, dictionary entries 38 

final assembly logical phase 67 

First Level Directory, format 385 

flow trace, not carried out by compiler 67 

FLOW/TRACE facilities 26.1 

flow/trace markers 86,86.1 

flowcharts (see also Phases and Modules) 
organization 71 
overall compiler logic 72-73 
resident control phase 74 

formal parameter list 39 

formal parameters, in CHECK or NOCHECK 

lists 38 

formats of dictionary entries 

freed registers 67 

FREEDSA 55 

function calls 42 

function references 41 

functions 32 


387-413 


generic built-in functions 33 
GENERIC entry label 42 

generic phase 43 

GET statements, library call 58 
GLOBAL region boundary 49 


halfword binary items 65 
hash chain, used to scan dictionary 37 
hash chains 33 
hash table 33 
address 31 
deleted 32 
in dictionary 31 
housekeeping 38 


identifiers 
contextual use 31 
implicit definition 31 
in compile-time processor output 
string 30 
in dictionary logical phase 31 
in multiple declarations 35 
when rejected 35 
IDV (see Initial Dope Vector) 
IEMAA 21 
IEMAF control section 458 
IEMKTAB macro 485 
IEMKTCA macro 483-484 
IF statements, count 29 


IHELSP 56 

IHEMAIN 69 
IHEQERR 68 
IHEQTIC 68 


IHESADA 68 
IHESADB 68 
IHESTGA 54 
IHESTGB 54 
in-line pseudo code 52-53 
INCLUDE data set 27 
inherited dimensions 38 
INITIAL attribute, second file entries 36 
Initial Dope Vector, scan for 
statements 51 


initial labels 
in pseudo-assignment statements 30 
subscripted label variables 30 
initialization 
of compiler 21 
of control routines 15 
input, original 27 
input text 17 
end-of-file indication 29 
input/output 
control routines 15 
control routines 23 
data set usage table 24 
data sets 15 
library call for RECORD I/O 56 
insertion file 66-67 
insignificant blanks, removed fron input 
text 29 
inter-phase dumping 25 
interface 
with data sets 23 
with operating system 15 
intermediate file 24 
internal code 29 
in text string 17 
internal entry point, diagram 33 
internal formats of dictionary 
entries 387-413 
Internal Formats of Text 414-448 
internal library routines 438-439 
interruptions, control routines 15 
invalid attributes, check for 34 
invalid characters 
diagnostics 28 
replaced by blanks 27 
used as markers 28 
invalid pictures 38 
invariance of subscripts 
IRREDUCIBLE 36 
iSUB references 40 
iSUBS 43 
ITDO region boundary 49 
iteration factors, initial value 32 
iterative DO-loops, dictionary entries 28 


48-49 


Job Control Language 15 
JOB statement 15 

job step 15 

job termination 23 


K phases, table handling routines 483-487 
KEYID routine 384 
KEYWD routine 384 
Keyword tables 
construction 384 


in read-in logical phase 30 


label table 29 

labels, inserted in dictionary 30 

level stack 37 

library call sequences 
for not in-line CHAR and BIT string 59 
for stroage triples 59 

library call 
data transmission 58 
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GET and PUT statements 58 
initialization 58 
RECORD~oriented I/O 56 
termination 58 
library calling sequences 438 
library conversion routines 68 
library error package 66 
library routines 
external 439 


FREEDSA 55 
IHELSP 56 

IHEQERR 68 
IHEQTIC 68 
IHESADA 68 
IHESADB 68 
IHESTGA 54 


IHESTGB 54 
internal 438-439 
library work store (LWS) 63 
Library, call code 46 
LIKE attribute 36 
LIKE chain 36 
line numbering 27 
Link Library 15 
Linkage Editor 15 
Linkage Loader 15 


lists 
SUBS/REGION 48 
USE 48 


load-ahead technique 35 

loader text, TXT cards 68 

location counter, for assembled code 68 
logical phases, table 18-19 

LWS (see library work store) 63 


machine instructions, in text string 17 
MACRO option 24,27 
macro-code interpreter 28 
main storage 
release of 26 
requirements 22 
Map, Phase-in-Storage 383 
marker byte function references 41 
markers (see also second level markers) 41 
argument 52 
constant 37 
end-of-program 54 
function call 42 
multiple assignment 54 
P format 37 
procedure calls 42 
pseudo-variable 54 
‘unsafe' 48 
use of invalid characters 28 
wanted or not wanted 44 
match chain, in SUBS TABLE 49 
message directory block 28 
messages (see also diagnostic messages, 
error messages) 
classification 23 
control routines 23 
diagnostic 15 
dictionary chain 23 
misaligned argument 65 
misaligned operands 65 
mixed overlay defining 47 
modules (see also Phases and Modules) 
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compiler control 24-26.1 
IEMAA 21 

MTF (multiplier function) 

MTF statement 39 

multiple assignment markers 54 

MULTIPLE ASSIGNMENT triples 59 


multiple declarations 35 


NAME card 69 

nested procedures, unnested at object 
time 68 

nesting, patch code 48 

NOCHECK lists, formal parameters 38 
‘not sold’ temporaries 42 

null arguments, in parameter lists 
NULL built-in function 42 

NULLO built-in function 42 


57-58 


object program 17 
OBJNM parameter 69 
OFFSET slots 403-404 
OFFSET 2 slot, diagram 402 
offset, calculation in structure 
processor 46 
ON conditions, dictionary entries 37 
ON statements, count 29 
OPEN control block 41 
OPEN statements, parameter list 57 
opening of data sets 21 
operators, in compile-time processor output 
string 30 
optimization byte 34 
optimization logical phase 47 
storage blocks 22 
optimization 
of DSA 64 
subscripts 48-49 
option list, printing 21 
options code byte 34 
options list, initial scan 21 
options 
ATR 39 
BY NAME 40 
check for legal combinations 58 
consistency 29 
Control Code word 17 
control section 25 
environmental 15 
in communications region 17 
in data flow diagram 16 
instructions to compiler 15 
interpretation of 15 
MACRO 27 
scanned 34 
source program 15 
Status byte 15 
stored in dictionary 17 
TRACE/PATCH 26 
XREF 39 
ORDER, default setting 47 
organization, diagram 20 
original input 27 
output string 
- from compile-time processor 30 
in read-in phase 29 
output, of read-in phase 29 


overlay defining 47 
mixed 47 
scalars 4&7 
undimensioned structures 47. 


padding, calculation in structure 
processor 46 
parameter description, in entry 
declaration 42 
parameter list 
DISPLAY statements 56 
for library call initialization 58 
for OPEN and CLOSE statements 57 
library calls 56 
null arguments 57 
WAIT statements 56 
parameter matching 32 
parameter registers 51 
parameters, of diagnostic messages 30 
PARTIAL SAFE/UNSAFE boundaries 49 
patch code 
in nest of loops 48 
in optimization phase 48 
PATCH/TRACE option 26 
patch file 47 
PATCH facilities 26.1 
PEXP (see pointer expression) 
PEXP statement 36 
deleted 39 
phase deleting 23 
phase directory 384 
construction 23 
error messages 23 
format 386 
status byte 15 
phase loading 23 
phase marking 23 
Phase-in-Storage Map 383 
phase, wanted/not wanted 23,35,44 
Phases and Modules - Guide 379-382 
Phases and Modules - Descriptions, 
Flowcharts, and Subroutine Tables 
AA 21,74,75-77 
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pointer expression (PEXP) 39 
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preprocessor 46 
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examples 460-465 
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correction 29 
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SYSPRINT 15 
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SYSUT1 15 
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closed for output 25 
control 24 
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TDPSCIE 25 
temporary description stack 
temporary descriptors 51 
Temporary Result Descriptor Triples (TMPD) 
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termination error messages 23 
termination of compilation 70 
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BUY statements 40 
I/O statements 40 
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temporary storage 40 
unbrella symbol 40 
text blocks 
chaining 22 
control 21 
markers 28 
release 28 
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first level table 
is pseudo-code 429 
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absolute code 
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in pseudo-code 429 
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MULTIPLE ASSIGNMENT 59 
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SPECIAL ASSIGNMENT 59 
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TXT (see loader text) 
type 1 entry 68 
types of dicticnary entries 32 
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undefines formal parameter 36 
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‘unsafe' variables 48 
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Variable Data Area 
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TCA (see table control area) 
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TRACE/FLOW facilities 26.1 
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